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Chapter 1. Overview 


This chapter is intended to give an overview of the new functions and features 
available with DB2 Server for VSE & VM Version 5 Release 1. The base functions 
and features are described briefly. Client/server solutions and data replication 
are also covered. Details of the environments required to support these products 
are supplied. 


1.1 New Capabilities 


1.1.1 Benefits and Customer Value 


This section discusses briefly the benefits of the new capabilities of DB2 Server 
for VSE & VM Version 5 Release 1 and what value you can extract from these. 


1.1.1.1 DRDA2 Distributed Unit of Work 

DRDA2 Distributed Unit of Work provides read and update capability at multiple 
locations and multiple databases within an LUW. This capability will free users 
from the task of synchronizing the data at multiple locations and at the same 
time they can place their data at different locations in accordance with their 
business needs. The data integrity is taken care of by the two-phase commit. In 
the first phase the requesting RDBMS talks to all participating RDBMSs to 
confirm if they are going to commit or roll back. In the second phase it directs 
each RDBMS to commit or rollback depending on the outcome of the first phase. 
Only if all participating RDBMSs want to commit, is the commit executed. 


1.1.1.2 Uncommitted Read 

Multiple read users can access the same data which has been changed and not 
yet committed or rolled back. This will provide the ability to create databases in 
which data can be accessed by many applications simultaneously while being 
updated by another application. This leads to better concurrency, higher 
availability of data, improves productivity and reduces the wait time. 


1.1.1.3 VSE Extended User Buffering 

By using Extended User Buffering of VSE the DB2 Server can now block multiple 
pages in one VSAM call. This enhances performance especially during dataload 
operations and writing of internal dbspace pages to DASD during sort, joins and 
view creations. 


1.1.1.4 Year 2000 Support 
DB2 Server for VSE & VM Version 5 Release 1 is completely Year 2000 compliant 
and thus will ensure investment protection at the turn of the century. 


1.1.1.5 Initialization Parameters 

Now the operator can display all parameters and change some of them after the 
database is started. Previously this could not be done. This reduces the time 
needed to change the parameters and increases the availability of the database 
as now it is not necessary to restart the database for the changes to take effect. 
Also, new initialization parameters have been introduced that can be used for 
performance tuning and to support distributed environments. 


O Copyright IBM Corp. 1997 1 


2 


1.1.1.6 VMSES/E Enablement 

VMSES/E is the strategic tool used to install and service VM products. VMSES/E 
enablement will allow VMSES/E support for DB2 Server for VM Version 5 
Release 1. This improves system management by having a single process for 
installation and service across the VM/ESA platform. This common process also 
increases DBA productivity by reducing the complexity of installation and 
maintaining products. 


1.1.1.7 Commitcount on DBSU Reload 

Reload now lets you execute the commit at pre-specified intervals. Therefore, 
you can avoid the necessity of switching logmodes for а large reload. Also this 
might help to keep the log small and thus would avoid а log full condition, 
depending on the logmode used. The use of this new function helps increase 
productivity by allowing the database to be available to more people more of the 
time. 


1.1.1.8 New COBOL Preprocessor Option 
А new COBOL preprocessor option has been introduced to improve the support 
of newer COBOL compilers, such as COBOL for VSE. 


1.1.1.9 Storage Pool Level Recovery 

Data Restore is an optional feature of DB2 Server for VSE & VM Version 5 
Release 1. Now Data Restore will let you recover from hard crash faster. Using 
Data Restore at storage pool level now allows you to restore only those storage 
pools which are affected by the hard crash instead of the whole database. This 
can reduce the time required to recover from а hard crash and increase 
productivity by improving database availability. 


1.1.1.10 DataPropagator Relational Capture for VSE & VM 

The database manager has been enhanced to support DPropR Capture for VSE 
& VM. DPropR is included in DB2 Server for VSE & VM Version 5 Release 1. It 
helps optimize network utilization, improves productivity and availability by 
providing consistent and timely data across all platforms. 


1.1.1.11 New Code Page Support 

DB2 Server for VSE & VM provides new code pages. This provides flexibility to 
grow and change the system transparently as the business needs change. This 
also enhances the ability to move applications and data across platforms. 


1.1.1.12 New Name 

The name has changed from "SQL/DS" to "DB2 Server for VSE & VM." This 
change makes it obvious that you are working with one of the DB2 family 
members. This makes sure that your current investments are protected and that 
you have a DB2 family solution to meet your needs as your business 
requirements change. Also the version count has changed; number four has 
been skipped. The common version count makes it easier to describe the 
cooperation capabilities between the family members on the same level. 
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1.1.2 DB2 Family 


The DB2 Family is not just a database. It is a complete database management 
solution. The DB2 family of products with some of its complementary products 
provide a wide range of solutions. The DB2 family of relational database 
products encompasses all kinds of IBM and non-IBM platforms ranging from 
enterprise to Intel and UNIX based systems. Your company's data can be on 
different systems and operating platforms ranging from workstations to 
mainframes. It can be at different geographic locations in the world or on your 
desktop - now you can access it seamless and transparently using the DB2 
family of products. 


Ge? Universal 
Database Servers 


* DB2 for AIX 

* DB2 for OS/2 

* DB2 for HPUX 

* DB2 for SCO 

* DB2 for Solaris 

* DB2 for SINIX 

* DB2 for Windows NT 


Enierprüse Servers 

* DB2 Server for OS/390 
* DB2 Server for VSE 

* DB2 Server for VM 

* DB2 Server for AS/400 


LAM 

* NetBIOS 

* TCP/IP 

* APPC/APPN 
* IPX/SPX 


Sisnc-Alone 
DES Personai КЕЙ 


Сей 

* 08/2 

* AIX 

* DOS 

" e HP-UX 

* Sun Solaris 

* SCO 

* SGI 

* Mac 

* SINIX 

* Windows 3.1 
* Windows NT 
* Windows 95 


bM 


За Paralel 

* * DB2 Server for OS/390 
ш. * DB2 Parallel Edition 
for AIX 


Figure 1. DB2 Family Servers and Requesters 


The Name Change 


The DB2 family of products consists of servers for VSE, VM, MVS, AIX, OS/2, 
HP-UX, Solaris, Sinix, Windows NT and AS/400. These server products are now 
categorized under new names with а common DB2 prefix. The reason for this 
change was to create an understanding that IBM's database products are 
available for all platforms and all these products belong to the same family and 
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thus а user should not worry about portability, scalability and large loss of 
investment. 


DB2 Server for VSE & VM 


Previously called SQL/DS, DB2 Server for VSE & VM Version 5 Release 1 is 
IBM's strategic database solution for VSE/ESA and VM/ESA operating systems. It 
provides robust, efficient and fast solutions for managing large amounts of data. 
It can be integrated with other IBM products to provide а comprehensive 
distributed database solution. Users can access data interactively with the help 
of а variety of tools. 


DB2 Server for OS/390 


DB2 for MVS has always been IBM's answer to the users” needs of an ultimate 
powerful database. Now the same power, reliability and usability is being 
provided only with a name change, DB2 Server for OS/390. DB2 Server for 
OS/390 provides a platform for application development and data management in 
an open client/server environment with а solid base for data integrity and 
security. 


DB2 Universal Database 


This is the industry's first web-enabled database with multimedia support. To 
provide secure Web connectivity it supports Net.Data, Java and Java Database 
Connectivity (JDBC). DB2 Universal database is available on the platforms: 


* AIX 

e OS/2 

e HP-UX 

* Sinix 

* Solaris 

* Windows NT 

* SCO OpenServer 


Apart from the platforms listed above, client platforms include DOS, Windows 3.1, 
Windows 95, Macintosh System 7, Silicon Graphics and IRIX. DB2 Universal 
database runs on Symmetric Multi-Processing (SMP) and Massively Parallel 
Processing (MPP) environments as well. This parallel capability answers the 
need for faster response while querying large amounts of data. DB2 Universal 
database does distributed multimedia data warehousing, complex querying and 
transaction processing all using the powerful DB2 engine. Its unique optimization 
techniques help improve the performance while doing complex querying. Single 
user versions are available on AIX, OS/2, Windows 95 and Windows NT. 


DB2 for AS/400 


DB2 for AS/400 is integrated with the hardware and operating system software to 
provide improved performance. An AS/400 user doesn't have to learn the 
intricacies of the database to be able to perform sophisticated database tasks. 


Complementary Products 


The DB2 family of products not only provides servers but also a lot of other 
products which complement DB2 to provide solutions in areas such as: 


* Business Re-engineering 
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* Data Warehousing 
* Data Mining 
* Data Pipelines and Data Highways 


* Application Solutions 
Visual Warehouse 


IBM's Visual Warehouse provides data warehousing solutions at the 
departmental level. It gathers data from operational systems, other data 
warehouses and personal systems and provides it to you to help in quick 
decision making. Others products can be used with it, such as DataJoiner to 
extract data from IBM and non-IBM databases and DataPropagator Relational to 
move data across systems. You don't need to have any other tools for data 
analysis and presentation, it is a complete LAN based solution. 


DataGuide 


DataGuide provides a catalog of data spread across multiple systems, different 
IBM and non-IBM platforms and across different geographies including the data 
in the form of traditional paper files. It helps users to find the data they want 
quickly. They can search the catalog using common business terms. DataGuide 
has utilities which can extract information about tables, queries, charts and 
spreadsheets from a large number of sources including Oracle. 


DataGuide lets you find the data you need and then helps you launch the tools 
you need such as a spreadsheet, a word processor or any other application. 


Lotus Approach 


Lotus Approach is a workstation product which lets you access data from DB2 
and then query and analyze it using exciting built-in utilities and features. You 
can query data, create reports and charts, create applications and analyze data 
using a powerful and user friendly interface. 


QMF 


QMF is a VM and VSE product which allows you to do data administration, query 
and analysis. It has client/server support from Windows 3.1, Windows 95 and 
Windows NT. QMF can access and analyze data from non-IBM sources using 
DataJoiner. It provides easy querying, report writing and table editing facilities 
with reliability and flexibility. 


DataPropagator Relational 


DataPropagator Relational replicates data between databases in the DB2 family. 
It creates and maintains a complete history of data changes. It supports the data 
concurrency requirements of operational applications. It recovers automatically 
from system and communication errors, ensuring reliable and repeatable 
performance. It provides for efficient operations that minimize impact to 
networks and production systems. DataPropagator Relational is easy to use and 
is completely automated. 
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DataJoiner 


Using DataJoiner you can access data residing on heterogeneous platforms and 
it is presented to you in а transparent manner in the form of а single image. 
Applications and tools running on clients can access data as if it is local data. 
DataJoiner along with DB2 WWW can let you access and build Internet 
applications using multivendor databases on the Web. 


DB2 WWW 


DB2 WWW enablement lets you use the Web to find information or to provide 
information on the Web. DB2 WWW allows SQL to be imbedded into standard 
HTML. Users on the Internet can now easily access data residing in DB2 
databases. While used with DB2, Net.data extends the same support to non-IBM 
databases. 


1.2 Base Functions 
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The following functions have been added to the base system of DB2 Server for 
VSE & VM Version 5 Release 1. They will be described briefly here. 


Uncommitted Read 


Multiple read-only users can now access data, including data that may have 
been modified but not yet committed. This capability will improve concurrency of 
access to the data, reduce potential deadlocking situations but reduce data 
integrity. The choice can now be made between improved concurrency and 
integrity of the data retrieved. 


To support the new isolation level uncommitted read, also new locking modes 
have been introduced and the meaning of existing locking modes changed. 


VSE Extended User Buffering 


Significant performance and throughput improvements can be realized with this 
capability. DB2 Server for VSE & VM Version 5 Release 1 exploits the enhanced 
VSAM buffering of the VSE operating system. 


In order to exploit this capability, some APARs must be installed on both DB2 
and VSE/ESA V2. 


Year 2000 Support 


DB2 Server for VSE & VM Version 5 Release 1 is fully Year 2000 compliant. Your 
data needs no conversion if you have been using the existing DATE, TIME and 
TIMESTAMP data types. 


Accounting records have been changed to four-digit years, using a protected 
field to be transparent to user-written applications. 


LTIMEOUT Initialization Parameter 


LTIMEOUT is a new initialization parameter that allows a timeout period to be 
set for lock waits. After the timeout, the LUW is rolled back with a return code. 
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Setting а timeout period can improve performance in applications where locking 
contention is impacting response times. It is also important when using DRDA 
level 2 with Distributed Units of Work, to be able to avoid global deadlocks. 


DSPSTATS Initialization Parameter 


DSPSTATS represents two new initialization parameters that can be helpful in 
performance tuning: 


The first one (first position) indicates whether (and how) checkpoint 
performance information is being displayed. 


The second parameter (second position), if given, indicates whether at 
shutdown counter information is displayed. This information is helpful 
because it gives the counter information of the latest point in time, even in 
the case of an abnormal end. 


SHOW INITPARM 


The startup parameters can now be viewed dynamically using the new operator 
command SHOW INITPARM. This command can be issued from ISQL, RXSQLOP 
or the operator console. Previously, access to the startup parameter file was 
required to determine which parameters were in effect. This enhances the 
usability of the database. 


SET Initialization Parameters 


The following startup parameters can now be modified dynamically from the 
operator console: 


* CHKINTVL to specify the maximum number of pages written to the log 
between checkpoints 

* DISPBIAS to define the mode how DB2 sets up task priorities 

* DSPSTATS to have performance specific information written 

* DUMPTYPE to give the type of dump written in case of a problem 

* LTIMEOUT to switch the lock wait timeout on and off and set the time interval 


This enhances the availability of the database, by avoiding the need to shut 
down the database to alter a parameter value. 


COMMITCOUNT on RELOAD 


A COMMITCOUNT value can now be specified on the DBSU command RELOAD. 
This allows a large RELOAD to be split into parts. After a failure, the process can 
be restarted after the row committed last. Therefore, also a RESTARTCOUNT 
parameter can be given and, for RELOAD DBSPACE also a RESTARTTABLE 
parameter to specify at which table the RELOAD DBSPACE process has to be set 
up again. 


This will improve the availability of the database. Also, depending on the 
logmode used, the commitcount on reload operations can reduce the need for 
processing large tables in SUM to avoid a log full condition and can reduce 
DASD requirements by using a smaller log. 


New COBOL Preprocessor Option 


The new COBOL preprocessor option “COBRC” has been introduced to support 
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the RETURN-CODE special register used with newer COBOL compilers, such as 
COBOL for VSE. 


VMSES/E Enablement 


А common installation and service process 15 now provided with the VMSES/E 
enabling of DB2 Server for VM. This is the strategic VM operating system 
method of delivering service to customers. For more details, refer to 2.1, 
"VMSES/E Enablement” on page 17. 


DB2 Data Spaces Support for VM/ESA 


The former "VM Data Spaces Support Feature" has been renamed to "DB2 Data 
Spaces Support for VM/ESA" and integrated with DB2 Server for VSE & VM base 
code. It has been VMSES/E enabled. It will include all fixes and enhancements 
made to the DB2 Server for VM base code. 


DB2 Data Spaces Support for VM/ESA is designed to significantly enhance the 
performance of DB2 Server for VM, by exploiting the VM/ESA Data Spaces 
capability. DB2 Data Spaces Support for VM/ESA uses a high performance DASD 
I/O system which gives a more effective way of retrieving data than the standard 
IUCV *BLOCKIO system. 


VM/ESA Version 2 Release 1 or later is required. 
Data Restore - Storage Pool Level Recovery 


Data Restore feature is an optional feature of DB2 Server for VSE & VM Version 
5 Release 1 and has been enhanced to allow partial recovery of a database at 
the storage pool level. This will improve database availability as the time 
required for a database restore due to DASD failure can be significantly reduced. 


Data Restore - SHOWPOOL 


Also, Data Restore feature offers a new command, SHOWPOOL. It can run even 
when the database manager is offline and shows the storage pools and their 
extents. This command supplements the RESTORE POOL functionality. 


1.3 Client/Server Solutions 


1.3.1 DRDA 


In this section we describe the client/server concept and what DB2 for VSE & VM 
Version 5 Release 1 has to offer there. Our implementation of the Distributed 
Relational Database Architecture (DRDA) is presented in Chapter 4, "DRDA 1 
Client/Server Implementation" on page 61 in detail. 


Client/server computing is almost a norm of the industry. Many people confuse it 
with downsizing or moving to a LAN environment and getting rid of mainframes. 
People have implemented client/server solutions using only PCs and 
workstations but the per unit cost for maintaining such a setup is very high. To 
be able to use the GUI applications on the workstations and still be able to 
enforce access control, data security, data integrity and daily backups with the 
reliability and stability of the mainframe, many of the organizations are now 
keeping their vital data on mainframes. 
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DRDA is the software architecture which lets you place your data on multiple 
platforms ranging from workstations to mainframes and then connects all this 
data in а transparent manner. DRDA does this using the DB2 family of products. 


At the moment DB2 for VSE & VM Version 5 Release 1 supports two levels of 
data distribution: RUOW and DUOW. 


1.3.1.1 Remote Unit of Work (RUOW) 

RUOW support provides read and update capability to one RDBMS at а remote 
location in one Logical Unit of Work (LUW). Each RUOW can contain multiple 
SQL statements but all should access the same RDBMS in one LUW. More than 
one RDBMS can be accessed but not in one LUW. 


1.3.1.2 Distributed Unit of Work (DUOW) 
In a DUOW more than one RDBMS at multiple locations can be accessed in one 
LUW. DUOW is implemented with the provision of two phase commit. 


Multiple databases can be read in the same unit of work and а single database 
can be updated. Moreover, if а sync point manager (SPM) is available, multiple 
databases can be updated. The SPM provides two-phase commit support. The 
SPM makes sure that all participating RDBMS are ready to commit data. If they 
are then it issues a "Commit for all" command. Otherwise if anyone is not 
ready, it issues a ”rollback for all”. (On the workstation database, the single 
updater, multiple reader rule can be enforced with the command SET CLIENT 
CONNECT 2 SYNCPOINT ONEPHASE.) 


1.3.1.3 Two-Phase Commit & the SPM 
In this section we describe the primary functions of a sync point manager (SPM). 


1. Keeping track of and logging LUW state information. 


2. Keeping track of and logging all local protected resource manager (PRM) 
names that are involved with a logical unit of work. 


3. Coordinating the COMMIT and ROLLBACK of all local PRMs. 


4. Initiating resynchronization protocols for any logical unit of work that may be 
in the in-doubt state because of a system or communication failure. 


An SPM is required wherever resources may be updated. This requires that the 
SPMs at all locations communicate with each other using some architected 
protocol. We present a sample sequence with the assumptions that no error 
situation occurs and conversation is successful between the server and the 
target communications manager (TCM). 
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Source Server 


Target Server 


OK Positive resonse SP SYNCPT verb CD Committed 
PP Prepare to commit TS Take Syncpt RC — Request commit FO Forget message 


CM Commit request 


Figure 2. Two-Phase Commit Flows Protocol 


1. 
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The Target Communications Manager (TCM) issues a RECEIVE AND WAIT 
APPC verb to receive the next SQL request from the source server. 


The source application program requests the SPM to commit the LUW. The 
source SPM notifies SNA LU 6.2 communications facilities and all 
participating databases to prepare to commit. The source communications 
facility sends the SNA LU 6.2 prepare message to the target system. The 
local protected resource managers respond to the source SPM with the 
"Request Commit" message. 


On the target system, the RECEIVE AND WAIT verb is completed and the 
WHAT RECEIVED parameter is set to TAKE SYNCPT. The TCM issues a 
SYNCPT verb to the target SPM which begins the commit processing. The 
SPM prepares the protected resources for commit. 


The SPM sends the SNA LU 6.2 "Request Commit" message to the source 
system. 


The source SPM collects the "Request Commit" messages from the SNA LU 
6.2 communications facilities and other protected resource managers. The 
source SPM then commits the LUW by requesting that all of the resources 
commit. This causes an SNA LU 6.2 committed message to be sent to the 
target system. 


The target SPM requests the local resources to commit the LUW and causes 
an SNA LU 6.2 forget message to be sent to the source system. In addition it 
sends a positive response to the TCM for the SYNCPT issued in step 3. 
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7. When the resource SPM receives the ”FO” message from the protected 
resource managers, а positive response to the commit is given to the 
application program. 


1.3.1.4 Resynchronization 

Resynchronization occurs if two-phase commit processing is interrupted by а 
resource failure. It can be caused by a node failure, a session failure, a program 
failure or any other problem detected by a protected resource manager. 
Resynchronization is conducted for each failed protected resource for which it is 
required. Resynchronization does the following: 


* Places distributed resources in consistent states, if possible. If not, it then 
notifies the operator at the LU that detected the damage. 


* Unlocks locked resources. 


* Updates the log to show that no more sync point monitoring is needed. 


1.3.1.5 Steps Involved in Resynchronization 
1. Restoring the data structure representing the status of sync point operation. 


2. Starting a program in the LU to initiate resync. 

3. Establishing a SYNC LEVEL (Confirm) with the resync ТР. 

4. Exchanging log names to verify that the partner has the appropriate LUW. 
5. Comparing and adjusting the states of the LUW at both partners. 


For a detailed discussion please refer to 5.1.4, "Resynchronization" on page 118. 
1.3.2 Enhancements Common to VSE and VM 


1.3.2.1 Log Changes 

There will be a slight increase in logging because more data will be logged on 
the existing log records for distributed units of work. This increase will be 
transparent to the user. 


1.3.2.2 Initialization Parameter to Disable SPM Support 

The server requires an initialization parameter that can suppress its ability to 
use the SPM. If "Y" is specified, the server will use an SPM if possible to 
coordinate two-phase commits and resync activity. If "N" is specified, the server 
will not use an SPM. In this case DB2 for VSE & VM is limited to multi-reads, and 
single write DUOW. If “Y” is specified and no SPM is available, then the server 
will operate as if "N" was specified. The default is SYNCPNT=Y. 


1.3.2.3 Heuristic Commit and Rollback of DUOW In-Doubt 
Transactions 

A heuristic commit and rollback of an in-doubt transaction is one that is initiated 
manually by an operator. This action should be based on the knowledge of the 
application. Heuristic damage is done when a heuristic commit or rollback is 
performed and at a later time the transaction manager wants to resolve the 
in-doubts but an opposite action was performed heuristically. The only way to 
correct such a damage is to restore the database from archive, keeping all the 
application servers in mind for consistency. 
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Heuristic actions can be performed on transactions which are not in-doubt and 
these transactions are not logged. Heuristic damage can occur on these 
transactions as well. 


The New SHOW INDOUBT Command 


Use this command to display the in-doubt LUWSs. This will display TRANID, 
USERID, LUWID, EXTNAM, REQUESTER, PACKAGE, STATE, DAMAGE, 
Prepare-To-Commit state started timestamp and heuristic state started 
timestamp for all in-doubt LUWs involved in the two-phase commit. 


»»—SHOW INDOUBT pt 


The New RESET INDOUBT Command 


Records of in-doubt LUWs which have been forced by heuristic actions can be 
erased using the RESET INDOUBT command. This should not be done until after 
they have been reconciled with directions from the recovery server. The operator 
can specify one or more TRANIDs for the in-doubt LUWs which have been forced. 
The value of the TRANID is obtained by issuing the SHOW INDOUBT command. 


io 
»»—RESET INDOUBT—( tranid——) >< 


FORCE Command Changes 


The FORCE command is used to perform heuristic operations. Now if a FORCE 
command is issued for an in-doubt agent which was involved in a DUOW, a 
warning is issued. 


SHOW CONNECT Changes 


The SHOW CONNECT command is enhanced to display the protocol that the 
requester is using. 


1.3.2.4 Database Lock Wait Timeout to Avoid Global Deadlock 

A new initialization parameter LTIMEOUT can be specified to provide a general 
lock wait timeout function for any SQL application as a way to avoid global 
deadlocks for DUOW applications. This parameter specifies the number of 
seconds before a lock wait will time out. The range of the LTIMEOUT value is 0 
to 99999 seconds. 


For a more detailed discussion of these topics refer to Chapter 5, “DRDA2 
Client/Server Implementation, Usage and Solutions” on page 115. 
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1.3.3 DataPropagator Relational Capture 


DataPropagator Relational replicates data among distributed databases. Simply 
put, DataPropagator Relational copies data from DB2 source tables into DB2 
target tables. The copy can be a full refresh or a differential refresh. 


Either of the following products is required for the DataPropagator Relational 
Capture: 

* VM/ESA Version 2 Release 1 or later 

* VSE/ESA Version 2 Release 1.2 or later 


1.4 Features Summary 


This chapter gives a brief overview of the features available for DB2 Server for 
VSE & VM Version 5 Release 1. 


Note! 


All existing features of DB2 have been updated to DB2 Server for VSE & VM 
Version 5 Release 1 and the new level MUST be used. 
Do not intermix levels! 


DB2 REXX SQL for VM/ESA 


RXSQL for VM has been renamed DB2 REXX SQL for VM/ESA and repackaged 
for this release to include all PTFs incurred to date. 


DB2 REXX SQL for VM/ESA allows REXX to access DB2 Server for VM. SQL, the 
language used to interface to DB2 Server for VM, can be imbedded in procedural 
languages such as C or COBOL. DB2 REXX SQL for VM/ESA extends this 

support to REXX EXECs. 


The following product is required: 


* VM/ESA Version 2 Release 1 or later 
DB2 Data Restore feature for VSE and VM 


Using the possibilities offered by the DB2 Data Restore feature, customers can 
reduce their archiving time, effort, and resources. Online archives can replace 
offline user archives, increasing the availability of the database. Duplicate 
backups, which currently are often practiced, can be avoided, while at the same 
time the recovery capabilities are improved. 


Either of the following products is required for the Data Restore feature: 
* VM/ESA Version 2 Release 1 or later 
* VSE/ESA Version 2 Release 1.2 or later 
Control Center 
SQL Master for VSE & VM has been renamed to Control Center and is now an 
optional feature of DB2 Server for VSE & VM Version 5 Release 1. Control 


Center simplifies the task of supporting DB2 Server for VSE & VM databases by 
automating the complex steps required to perform many database administrator 
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activities. With Control Center, these functions can be scheduled and performed 
automatically during periods of low system usage, with little or no intervention, 
improving the operational productivity of the entire system. On VM, Control 
Center also gives users the ability to automate, manage, track, and schedule 
Data Restore functions on one or more DB2 servers. 


Either of the following products is required for the Control Center: 
* VM/ESA Version 2 Release 1 or later 


* VSE/ESA Version 2 Release 1.2 or later 


Additional prerequisites are needed to support Control Center for VSE. Please 
refer to the Control Center for VSE Installation and Operations Guide, SC17-2000 
for that information. 


1.4.4 New Product 


DB2 VSAM Transparency for VSE/ESA Version 5 Release 1 


Note! 


This is not a feature of DB2 Server for VSE & VM Version 5 Release 1. 
DB2 VSAM Transparency for VSE/ESA is a separate product (5697-B88). 


DB2 VSAM Transparency for VSE/ESA offers an alternative solution for the 
conversion of VSE/VSAM data files to DB2 Server for VSE tables. It avoids the 
need for costly program and application rework by transparently routing 
VSE/VSAM calls to DB2 accesses. 


DB2 VSAM Transparency for VSE/ESA intercepts the VSE/VSAM request from an 
application program and performs the requested action on a DB2 Server for VSE 
or on a DB2 Server for VM in a Guest Sharing environment. To enable DB2 
VSAM Transparency for VSE/ESA, no changes are required to the application 
programs. 


For more details, refer to the ITSO redbook How to Get to DB2 from VSE/VSAM 
Using DB2 VSAM Transparency for VSE/ESA, SG24-2039. 


1.4.2 Dropped Support 
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DataHub Support for VM 


This is no longer provided as the DataHub for OS/2 Version 2 end of service date 
has been announced for September 1997. 


User Facility Subset 


This will no longer be delivered in DB2 Server for VSE & VM Version 5 
Release 1. 


RPG Preprocessor 


The preprocessor for RPG/370 is no longer delivered because RPG/370 has been 
out of service since 1995. Packages existing in the database will continue to run. 
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1.5 Environments Supported 


1.5.1 Hardware 


1.5.2 Software 


Processors 


DB2 Server for VSE & VM Version 5 Release 1 will run on any IBM processor, 
with the conditional swapping and extended precision floating point features, 
supported by one of the following operating systems: 


* VM/ESA Version 2 Release 1 or later 
* VSE/ESA Version 2 Release 1.2 or later 


DASD 


DB2 Server for VSE & VM will use all DASD devices supported by the operating 
systems through VSAM data management facilities in VSE ог DASD Block I/O 
Facilities in VM. If available, DB2 Server for VM takes advantage of DFSMS/VM 
to perform certain tasks. The DB2 Data Spaces Support for VM/ESA will run on 
all current DASD devices supported by the VM/ESA Paging Subsystem. 


Tape Requirements 


DB2 Server for VSE & VM will use, through VM or VSE, tape-handling devices 
supported by those operating systems. 


Terminal Requirements 


ISQL Terminal Support. ISQL will support 3270 compatible terminals. 


DBS Utility Terminal Support. The DBS Utility supports a terminal interface 
through ICCF for VSE and CMS for VM. 


Printer Requirements 

In a VM environment, results from ISQL, the interactive facility of DB2 Server for 
VM, may be printed on any system printer supported by VM, or any remote 
printer through the RSCS networking supported by the operating system. 

In a VSE environment, ISQL results may be printed on any system printer using 
VSE/POWER supported by the VSE/ESA operating system. Any IBM 3270 


Information Display System terminal printer supported by the Basic Mapping 
Support facility of CICS/VSE can print the ISQL results. 


VM/ESA 


DB2 Server for VSE & VM Version 5 Release 1 is supported on VM/ESA Version 
2 Release 1 or later. 
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RSCS. ISQL uses Remote Spooling Communications Subsystem (RSCS) Version 
3 Release 2 or later for terminal printer support. 


VM/VTAM. VTAM Version 4 Release 2 is required for Distributed Relational 
Database Architecture. 


DFSMS/VM. If DFSMS is installed, DB2 Server for VM uses DFSMS/VM Function 
Level 2.2.1 or later for the copy DBEXTENT function. 
VSE/ESA 


DB2 Server for VSE & VM Version 5 Release 1 is supported on VSE/ESA Version 
2 Release 1.2 or later, which includes: 
• VTAM Version 4 Release 2 


* CICS/VSE Version 2 Release 3 
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Chapter 2. Base and Features Implementation 


This chapter describes the process for the migration of SQL/DS Version 3 


Release 5 to DB2 Server for VSE & VM Version 5 Release 1 in both the VM and 
VSE environments. 


2.1 VMSES/E Enablement 


VMSES/E is the strategic tool used to install and service VM products. DB2 


Server for VM with DB2 Data Spaces Support for VM/ESA have been VMSES/E 
enabled for this release. 


VMSES/E will enhance reliability and service via its Software Inventory feature, 


which will enable precise tracking of applied service, and provide uniform and 
consistent install and build methodologies. 


This feature is only available on VM. 


VMSES/E capabilities include: 


• Installing new VM systems and program products. 
* Helping tailor products through local modifications. 
* Servicing products (corrective, preventive, refresh). 
* Keeping a record of what has been done. 


VMSES/E is enabled for the DB2 Server for VM product including NLS support 


and the DB2 Data Spaces Support for VM/ESA. VMSES/E enablement provides 
the following: 


An install and service tool which is also common to other VM products. 
* Online HELP files for all VMSES/E commands. 


A Software Inventory - a collection of files which contain control and status 
information used during product installation and service: 


Automatic creation and maintenance of the Software Inventory. 


— Two levels of information: 


- The system-level Software Inventory contains information on all 
products installed on the system. 


- The service-level Software Inventory contains information about all 
service applied to each product in a system. 


Query and Manipulation Facility (Software Inventory Management), 
providing both user and system access to the Software Inventory tables. 


VMSES/E maintains Software Inventories only for products that use VMSES/E 
for installation and service. 


* An installation function that can: 
— Install the DB2 Server for VM product. 


Assist in planning additions, migrations, and deletions of the product or 
product features. 


— Migrate without changing tailored files. 
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— Optionally define/delete resources such as user IDs, minidisks, and so 
on, when installing or migrating. 


* А service process that: 


Effectively controls back-levelling. No executable code will be loaded 


from service tapes, unless requested for Recommended Service Upgrade 


(RSU) service. 


Enables selective PTF application. 


— Allows PTF removal (not automated). 


Automatically detects part changes to determine which objects need to 
be rebuilt. 


Has a planning, or dry-run, capability for prototyping the effects of 
applying a PTF. 


* Support for managing saved segments, seamless with product servicing. 


Many programs and files have been changed or removed with the VMSES/E 
enablement. This product has absorbed the functionality of these programs. 


Migration from releases prior to SQL/DS Version 3 Release 1 will no longer be 
supported. Migrating from a previous version requires a migration to any 
Release of SQL/DS Version 3 first; best would be to Release 5. 


2.2 Migration on VM/ESA 


This section describes how we migrated an existing SQL/DS V3R5 database to 
DB2 Server for VSE & VM. 


For a complete description of installation requirements and considerations refer 
to the Program Directory shipped with the product. The Installation Manual for 
VM no longer exists. 


2.2.1 VMSES/E Migration Process Overview 
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The following is a brief description of the main steps we used for migrating 
SQL/DS V3R5 using VMSES/E. In this migration process, the default user ID and 
minidisk were not used. Instead, a PPF override was created to migrate to a 
different user ID and minidisks. 


1. Preliminary Migration Step 
Prepare the existing database and database machine for the migration. 
2. Plan Your Installation 


Use the VMFINS command to load several VMSES/E files from the product 
tape and to obtain DB2 Server for VM resource requirements. 


3. Allocate Resources 


The information obtained from the previous step is used to allocate the 
resources needed to do the migration process. 


4. Install DB2 Server for VM 


Use the VMFINS command to load the DB2 Server for VM files from the tape 
to the minidisks. VMFINS is then used to update the VMSES/E software 
inventory file. 
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Migrate the DB2 Server for VM Database 


Run the DB2 Server for VM migration execs to update information in the 
current database. 


. Copy DB2 Server for VM Files into Production 


Copy the product files from the test disks to the production disks. 


. Post Migration 


Describes the optional administration and customization tasks. 


. DB2 Server for VM Features Migration 


At this point you can migrate the optional DB2 Server for VM features you 
have installed. 

In the following discussion, we only mention steps differing from the Program 
Directory. 


2.2.2 Plan Your Installation 
If you are using the defaults supplied with 564815A1 you do not need to create а 
PPF override. 


If you change the PPF name, а default user ID, or other parameter via а PPF 
override, you will need to use your changed values instead of those indicated 
(when appropriate), throughout the rest of the migration process. 


Following is the sample console output presented during the PPF override 
creation process. 


- 


Reading VMFINS DEFAULTS В for additional options 
VMFINS processing started 
VMFINS2601R Do you want to create an override for :PPF 564815A1 DB2VM 


ҮМЕМК027601 VMFMKOVR processing started 
Now creating override for product :PPF 564815A1 DB2VM? 


VMFMK02917R Do you want to use the defaults for this product? 


:PRODID 564815A1%DB2VM? 
Enter 0 (No), 1 (Yes) or 2 (Exit) 


:PRODID 564815A1%DB2VM 


Enter 0 (No), 1 (Yes) or 2 (Exit) 


Figure 3. Creating PPF Override 
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- 


Storage resource for product 564815A1%DB2VM component DB2VM 
DB2 for VM INSTALL Use. 564815A1 


564815A1 Userid A-di. 191 Link ав......... 191 
Initial product code. 2B2 Link as.i.. se 2B2 
Production SAMPLE di. 2C2 Link as......... 2C2 
Production APPLY dis. 2A2 Link as......... 2A2 
Alternate APPLY disk. 2A6 Linkas spas vs 2A6 
Production DELTA dis. 2D2 Link as......... 2р2 
Test BUILD disk serv. 193 Link а5......... 193 
Test BUILD disk prod. 195 Link as......... 195 
DB2 for VM User Machin. SQLUSER 
DB2 for VM User Mach. 191 Link as......... 991 
DB2 for VM Database Ma. SQLMACH 
Production Service B. 193 Link as......... 293 
Production BUILD dis. 195 link as: 295 
Starter Database Dir. 200 Link а5......... 200 
Starter Database Log. 201 Link а$......... 201 
Starter Database Dat. 202 Link а5......... 202 
DB2 for VM Database . 191 Link a9... 192 


Figure 4. Default User IDs and Minidisks Supplied with the Product 


Storage resource for product 564815A1%DB2VM component DB2VM 
DB2 for VM INSTALL Use. eldb2 


564815A1 Userid A-di. 291 Link as......... 291 
Initial product code. 282 Link as......... 2B2 
Production SAMPLE di. 2C2 Link :а5 0а 2C2 
Production APPLY dis. 2A2 Link as......... 2A2 
Alternate APPLY disk. 2A6 Link as......... 2A6 
Production DELTA dis. 2D2 Linc às. oes 2D2 
Test BUILD disk serv. 293 Link as......... 293 
Test BUILD disk prod. 295 Link as......... 295 
DB2 for VM User Machin. SQLUSER 
DB2 for VM User Mach. 191 kink абыз o ee 991 
DB2 for VM Database Ma. eldb2 
Production Service B. 193 Link as......... 193 
Production BUILD dis. 195 Link as......... 195 
Starter Database Dir. 200 Link as......... 200 
Starter Database Log. 201 Link as......... 201 
Starter Database Dat. 202 Link as......... 202 
DB2 for VM Database . 191 Link as......... 191 


Figure 5. Changes Made to the Default Values 
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= 
Storage resource | Save as... 

DB2 for VM IN | 
564815A1 Us | File name...... db2mig 
Initial pro | File type.....: $PPF 
Production | File mode..... А 
Production | Description.... DB2 for VM 4.1.0 
Alternate A | 
Production | 
Test BUILD | F12-Cancel 
Test BUILD | 

DB2 for VM User Machin. SQLUSER 
DB2 for VM User Mach. 191 Link as......... 991 

DB2 for VM Database Ma. ELDB2 
Production Service B. 193 Link as......... 193 
Production BUILD dis. 195 Link as......... 195 
Starter Database Dir. 200 Link as......... 200 
Starter Database Log. 201 Link as......... 201 
Starter Database Dat. 202 Link as......... 202 
DB2 for VM Database . 191 Link as......... 191 


Figure 6. Creating a PPF Override File Named DB2MIG 


2.2.3 Allocate Resources 
This step describes the changes to the system directory. A new production (295) 
and service (293) minidisk will be defined. 


1. Add the necessary minidisks to the directory for the user ID ELDB2. 


2. Place the new directories online according to your CP directory maintenance 
method. 


3. Format the new minidisks before installing DB2 Server for VM. 


4. Copy all files from the existing production minidisk (ELDB2 195) to the new 
minidisk (ELDB2 295). The migration process will use the new production 
minidisk (ELDB2 295). You must do this step before you install code. 


2.2.4 Install DB2 Server for VM 


The PPF name to be used throughout these installation instructions is DB2MIG 
which as shown in Figure 6. If you have your own PPF override file, you should 
use your file’s ppfname instead of DB2MIG. 


1. Log on to the installation ID ELDB2. 
2. Establish read access to the VMSES/E code. 
link MAINT 5e5 5e5 rr 
access 5e5 b 
3. Establish write access to the software inventory disk. 
link MAINT 51d 51d mr 
access 51d d 


4. Have the DB2 Server for VM installation tape mounted and attached to 
ELDB2 at virtual address 181. 
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5. Install DB2 Server for VM 
vmfins install ppf DB2MIG DB2VM (nomemo nolink 
Use DB2VM for installing on minidisks. 


The nolink option indicates that you don't want VMFINS to link to the 
appropriate minidisks, only access them if not accessed. 


Reading VMFINS DEFAULTS B for additional options 
VMFINS processing started 
VMFINS2601R Do you want to create an override for :PPF DB2MIG 
DB2VM :PRODID 
564815A1%DB2VM? 
Enter 0 (No), 1 (Yes) or 2 (Exit) 
0 
Processing product :PPF DB2MIG DB2VM :PRODID 564815A1%DB2VM 
Product :PPF DB2MIG DB2VM :PRODID 564815A1%DB2VM has passed 
requisite checking 
Installing product :PPF DB2MIG DB2VM :PRODID 564815A1%DB2VM 
VMFSETUP processing started for DB2MIG DB2VM 
Minidisk|Directory Assignments: 
String Mode Stat Үдеу Label/Directory 


LOCALSAM E R/W 2C2  DBI2C2 
APPLY F R/W 2A6 ПВІ2Аб 

G R/W 2A2  ELD2A2 
DELTA H R/W 2D2 DBI2D2 
BUILD2 I R/W 295  DB2195 
BUILDO J R/W 293  DB2193 
BASE K R/W 282  DBI2B2 
SYSTEM Е R/O 195  ELD195 

M R/0 193  DB2193 
-------- А R/W 191  DB2191 
-------- В R/O 5E5  MNT5E5 
-------- D R/W 51D  ELD51D 
-------- 5 R/O 190 MNT190 


-------- Y/S R/O 19E  MNTI9E 
VMFSETUP processing completed successfully 
VMFREC processing started 

Volume 1 of 1 of INS TAPE 9700 

(1 of 7) VMFRCAXL processing AXLIST 
Loading 0 part(s) to DELTA 2D2 (H) 

(2 of 7) VMFRCPTF processing PARTLST 
Loading 0 part(s) to DELTA 2D2 (H) 

(3 of 7) VMFRCCOM processing DELTA 
Loading 0 part(s) to DELTA 2D2 (H) 

(4 of 7) VMFRCALL processing APPLY 
Loading part(s) to APPLY 2A6 (F) 

Loaded 1 part(s) to APPLY 2A6 (F) 

(5 of 7) VMFRCALL processing BASE 
Loading part(s) to BASE 2B2 (K) 

Loaded 1395 part(s) to BASE 2B2 (K) 

(6 of 7) VMFRCALL processing BUILDS 
Loading part(s) to BUILDO 293 (J) 

Loaded 1387 part(s) to BUILDO 293 (J) 

(7 of 7) VMFRCALL processing BUILDP 
Loading part(s) to BUILD2 295 (I) 

Loaded 67 part(s) to BUILD2 295 (I) 
VMFREC processing completed successfully 
Product installed 

VMFINS processing completed successfully 


Figure 7. Sample Installation Console 
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6. Review the install message log. If necessary, correct any problems before 
going on. 
vmfview install 

7. Update Build Status Table for DB2 Server for VM 


The following command will update the VM SYSBLDS software inventory file 
for DB2 Server for VM. 


vmfins build ppf DB2MIG DB2VM (serviced nolink 
8. Review the install message log. If necessary, correct any problems before 
going on. 


vmfview install 


2.2.5 Database Migration 
1. Log on to the ELDB2 virtual machine. 


2. Run ARISINST with the MIGRATE option. 


Some files that exist on the current database machine production minidisk 
will be overwritten on the new database machine production minidisk. These 
files will be placed on the new 2C2 disk and will have an 'O' appended to the 


front of the filetype. 
arisinst m DB2MIG DB2VM 
3. Log off ELDB2. 


2.2.5.1 Prepare for Database Migration 
1. Log on to the ELDB2 virtual machine. 


2. Link and access the installation user ID test production and test service 
disks. 


link ELDB2 295 295 w 
access 295 e 
link ELDB2 293 293 w 
access 293 f 


set lang ameng (add ari user 
Now, we run the necessary exec as described in the Program Directory. 
2.2.6 DB2 Server for VM Features Migration 


If you have currently installed one or more of the optional DB2 Server for VM 
features, you can migrate them at this time. 


Note 


Only features of DB2 Server for VM Version 5 Release 1 can be used with the 
DB2 Server for VM Version 5 Release 1 base product. There will be no 
support for using SQL/DS V3R5 features with the DB2 Server for VM Version 
5 Release 1 base product. 
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2.2.6.1 Migrating RXSQL 
To migrate RXSQL follow the instructions described in the REXX Interface 
Installation manual. 


2.2.6.2 Migrating Data Restore Feature 
To migrate Data Restore feature follow the instructions described in the DB2 for 
VSE and VM Data Restore Guide. 


2.2.6.3 Migrating SQL Master for VSE & VM to Control Center 

To migrate earlier levels of SQL Master for VSE & VM (Version 1.1.2 or 1.2.0) to 
Control Center, depending on your environment, follow the steps described in 
the appropriate Control Center Installation and Operations Guide. 


2.3 Migration on VSE/ESA 


2.3.4 About our 


In this section we will explain some experiences we had during our migration 
process from SQL/DS Version 3 Release 5 to DB2 Server for VSE Version 5 
Release 1. 


For a complete description of installation requirements, considerations and how 
to migrate an existing database, refer to the DB2 for VSE Installation manual. 


Migration 

To start the migration of an existing SQL/DS Version 3 Release 5 database to 
DB2 Server for VSE Version 5 Release 1, you need to follow some of the general 
preparation steps, then you can proceed with the migration steps. For our 
database, we executed the following steps: 


1. Preparation step 1 - DASD Allocation 

Preparation step 3 - Set up the VSE Environment 
Preparation step 4 - Prepare CICS System 

Preparation step 7 - Restore the Distribution Library 
Migration step 1 - Space Verification 

Migration step 2 - Archive the Database 

Migration step 3 - Prepare the Database for Migration 
Migration step 4 - Format the DB2 Server for VSE Logs 
Migration step 5 - Update the DB2 Server for VSE Catalog 
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— 


Migration step 6 - Reload the DBS Utility Package 


— 
— 


. Migration step 7 - Update the DB2 for VSE Database 
12. Migration step 8 - Migrate the Help Text Tables 
13. Migration step 14 - Reset the Password for User SQLDBA 


In our case, just the above steps were necessary to completely migrate our 
database. As all environments are different and have their own requirements, we 
suggest you consult the DB2 for VSE Installation manual, where there is a 
complete description of each step, to decide which ones are mandatory or 
optional for your database migration. 
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2.3.2 Preparation and Migration Steps 


This section describes our procedures to migrate the database and gives you 
some hints to make your migration as easy as possible. 


2.3.2.1 Preparation Step 1: DASD Allocation 

For this step, we prepared for the installation and loaded the product tape in 
advance, instead of using 2.3.2.4, "Preparation Step 7: Restore the Distribution 
Library” on page 26. 


We suggest you use the Interactive Interface (Il) to load the product tape into the 
PRD2.DB2510 sublibrary. The generated job from the II will create this sublibrary. 


* Use Fastpath 111 to prepare the installation 


* Use Fastpath 112 to download the product tape into PRD2.DB2510 


2.3.2.2 Preparation Step 3: Set Up the VSE Environment 
In this step the main issue is the partition size. For our database a partition size 
of 10M was enough. 


2.3.2.3 Preparation Step 4: Prepare the CICS System for DB2 
Server for VSE 

Because we were migrating from SQL/DS Version 3 Release 5, all modifications 
to be made to the CICS Startup JCL were already made. The only modification 
not considered was the ASSGN command because we are not going to print any 
report from ISQL using the PRINT command. 


If you are going to use tables for the VSE online support and ISQL the following 
tables must be modified: 


DFHPCT If you are migrating from SQL/DS Version З Release 5, you do not 
need to modify your PCT. If you are migrating from an older release, 
we suggest you remove the old entries and include a copy of the 
ARIS51PC book from the PRD2.DB2510 library. Starting with SQL/DS 
Version 3 Release 5, the new database switching support requires 
some additional transactions. 


DFHPPT If you are migrating from SQL/DS Version З Release 5, you do not 
need to modify your PPT. If you are migrating from an older release, 
we suggest you remove the old entries and include a copy of the 
ARIS51PP book from the PRD2.DB2510 library because the new 
database switching support provided with SQL/DS Version 3 Release 
5 requires some additional programs. 


DFHSIT If you are migrating from SQL/DS Version З Release 5 and you are 
using the database switching support, you do not need to modify your 
SIT table. But if you are migrating from an older release, or from 
SQL/DS Version 3 Release 5 without using the database switching 
support and the CICS journaling support is not active, you must 
activate it by modifying your SIT table to specify the suffix of the 
DFHJCT in the JCT parameter. 


DFHTCT The settings for Version 3 are still valid for DB2 Server for VSE. 


DFHJCT Starting DB2 Server for VSE requires the CICS Journaling support. In 
order to activate this support you must modify your SIT table by 
specifying the suffix of the DFHJCT in the JCT parameter. 
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If you plan to use DRDA and access more than one database in the same LUW 
(DRDA Distributed Unit of Work) you must activate the CICS Restart 
Resynchronization Support as follows: 


1. Add the following line to the DFHPCT: 
* DFHPCT TYPE=GROUP,FN+RMI 
2. Add the following line to the DFHPPT: 
* DFHPPT TYPE=GROUP,FN+RMI 


2.3.2.4 Preparation Step 7: Restore the Distribution Library 
This step was already done as part of the 2.3.2.1, "Preparation Step 1: DASD 
Allocation" on page 25. 


Note: Once the above steps are completed, you can proceed with the steps 
listed in the migration chapter in the DB2 for VSE Installation, 
GC09-2391-00 manual. 


2.3.2.5 Migration Step 1: Space Verification 

This step checks the available space for the directory and storage pools. You 
should have at least four dbspace blocks available in the directory. It is 
recommended that each storage pool be less than 90% full and each pool must 
have at least 30 free pages. If you don't have the available space needed you 
have to increase it as described in Migration Step 1 in the DB2 for VSE 
Installation, GC09-2391-00 manual. 


In Figure 8 and Figure 9 on page 27, we show the information from our 
database. 


show dbconfig 
System identification at DB generation = SQL/DS VERSION 3 


F8 0008 

DBA specified the following at DB definition: 
Maximum pools - 999 
Maximum DBEXTENTS = 999 
Maximum DBSPACES = 10240 

F8 0008 

Computed: 
Total number of DBSPACE blocks = 23102 
Total amount of DBSPACE = 5914112 K 
Total number of physical pages = 1495040 
Total amount of physical space = 5980160 K 


Total number of directory blocks = 24600 


Number of DBSPACE blocks left = 2228 
ARIOO65I SQL/DS operator command processing is complete. 


Figure 8. Output from SHOW DBCONFIG Command 


As we can see there are 2228 dbspace blocks available, which allows us to 
proceed with the migration. 
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umm = 


um = 


show pool summary 


POOL TOTAL NO. OF NO. OF NO. OF % NO. OF 
NO. PAGES PAGES USED FREE PAGES RESV PAGES USED EXTENTS SOS 
1 2964 1981 983 20 66 2 
2 4446 38 4408 20 0 3 
3 4446 719 3727 20 16 3 
4 4446 5 4441 20 0 3 


FREE 1478738 
ARIOO65I SQL/DS operator command processing is complete. 


Figure 9. Output from SHOW POOL SUMMARY Command 


2.3.2.6 Migration Step 2: Archiving a Database 
Before continuing with the migration, you must archive your database for 
security reasons by typing the command 


SQLEND ARCHIVE 


2.3.2.7 Migration Step 3: Prepare the Database for Migration 

Run the job ARIS51ND and make all the necessary modifications according to 
your installation requirements by following the notes for the example described 
in the DB2 for VSE Installation manual. 


2.3.2.8 Migration Step 4: Format the DB2 Server for VSE Logs 

Use the job ARIS510OD for this step. Make all the necessary modifications 
according to your installation requirements and follow the notes for the example 
described in the DB2 for VSE Installation manual. 


2.3.2.9 Migration Step 5: Update the DB2 Server for VSE Catalog 
This step updates the DB2 Server for VSE catalog to the Version 5 Release 1 
level. Use the job ARIS51PD for this step. Make all the necessary modifications 
according to your installation requirements and follow the notes for the example 
described in the DB2 for VSE Installation manual. 


2.3.2.10 Migration Step 6: Reload the DBS Utility Package 
Punch the member ARIS51QD.Z from PRD2.DB2510, modify it according to your 
installation requirements and run it. 


In our case, we have our own database ID procedure. We moved it to 
PRD2.DB2510 and modified all the installation jobs so they referenced it. 


2.3.2.11 Migration Step 7: Update the DB2 for VSE Database 
Prepare the job ARIS51RD described in the DB2 for VSE Installation manual, 
make all the required modifications to meet your installation setup and run it. 


2.3.2.12 Migration Step 8: Migrate the HELP Text Tables 


Prepare the job ARIS51SD described in the DB2 for VSE Installation manual, 
make all the required modifications to meet your installation setup and run it. 
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2.3.2.13 Migration Step 14: Reset the Password for User SQLDBA 
This step is mandatory if you changed the password in 2.3.2.7, "Migration Step 3: 
Prepare the Database for Migration” on page 27. 


2.3.3 DB2 Server for VSE Features Migration 


If you have currently installed one or more of the optional DB2 Server for VSE 
features, you can migrate them at this time. 


Important ... Important 


Only features of DB2 Server for VSE Version 5 Release 1 can be used with 
the DB2 Server for VSE Version 5 Release 1 product. There will be no support 
for using SQL/DS Version 3 Release 5 features with the DB2 Server for VSE 
Version 5 Release 1 product. 


2.3.3.1 Migrating Data Restore Feature 
To migrate the Data Restore feature follow the instructions described in the Data 
Restore Guide. 
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Chapter 3. Base and Features Usage 


This chapter describes the new functions and features of the base system of DB2 
Server for VSE & VM Version 5 Release 1. It includes details on the usage of 
these functions and advantages in relation to performance, availability and 
usability. Some examples have been included to demonstrate the use of these 
functions and features. 


Some of these enhancements and features are restricted to а particular 
operating system. 


3.1 Uncommitted Read (Dirty Read) 


The isolation level Uncommitted Read (UR) gives users the ability to create 
databases in which data can be queried simultaneously by many applications 
while being updated by another application. This will prevent read-only 
applications from waiting on applications that have changed or may change the 
data about to be read. This will provide greater concurrency and throughput. 
The isolation level UR is defined as follows: 


* An application can see uncommitted changes made by other application 
processes. 


* An application cannot update uncommitted changes made by other 
application processes. 


* The re-execution of a statement can be affected by other application 
processes. This means, the results can differ. 


* Updated rows cannot be updated by other application processes. 


* Updated rows can only be read by application processes using isolation level 
UR. 


* Accessed rows can be updated by other application processes. 
* Accessed rows can be read by other application processes. 


* The current row of a read-only cursor can be changed by other application 
processes. 


* The current row of an updateable cursor cannot be changed by other 
application processes. 


3.1.1 Usage 


The isolation level UR can be specified in the following ways: 


1. The SELECT statement has a new WITH clause that allows the isolation level 
to be specified. 


The new syntax is as follows: 
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3.1.2 Locking 


r—— select 


»—fullselect— Г | > 
torder-by-clause4  —with-clause— 
L-update-clause—— 


r—— select-into 


А | 
»»—select-clause—1 NTO— fios t-variable—-——from-clause » 


rT Г] | dini 
—where-clause— . —with-clause— 


m with-clause 
»— I TH—-RRq » 
Еш 
tyro 


Figure 10. Syntax of the SELECT Command 


The INSERT, UPDATE and DELETE statements also have the new WITH 
clause, but will only be able to specify RR or CS levels. 


2. When preprocessing an application program. 


* In VM, the SQLPREP statement has an ISOL parameter where the 
isolation level can be defined. See the DB2 for VM Application 
Programming, SC09-2392 manual for more details. 

* In VSE, the ISOL parameter can be defined as an option of the PARM 
keyword of the job control EXEC statement. See the DB2 for VSE 
Application Programming SC09-2393 manual for more details. 


3. In ISQL or DBSU using the SET ISOLATION UR statement. 


r—- Warning 


The dirty read capability introduces data integrity issues. Users can see data 
that has changed but has not yet been committed. This data may be rolled 
back to its original state, but the user reading the changed data is not aware 
of that. They may use this data as input to another application, that could 
then contain incorrect or invalid results. This should be considered when 
using isolation level UR. 


Therefore, when you read data with the intent to use it as input to a 
database, it is preferable to use either of the isolation levels RR or CS. 
Similarly, you have to decide upon other applications' usage of data read 
with isolation level UR. 


The isolation level UR is only available on data in public dbspaces with row or 
page level locking. If data is either in a private dbspace or in a public dbspace 
with dbspace level locking, isolation level RR will be used if UR has been 
requested. 
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Two new locking modes have been introduced to handle the isolation level UR. 


IN (Intent None) Acquired for read-only operations under isolation level UR 
for read of any data, even uncommitted data. Can be 
obtained at the dbspace, table, page or row level. This 
lock prevents index or data pages being split while 
reading. 

Z (Super Exclusive) Acquired at dbspace, table, page or row level. No other 
applications can read or update an object locked in Z 
mode, even if using isolation level UR. This is supposed to 
be used during index data page splitting. 


Lock mode X has been modified. 


X (Exclusive) Exclusive locks are acquired for DML operations only. 
Objects locked in X mode can be read by applications 
using isolation level UR. 


Other changes include: 
* DDL statements will acquire а Z lock on the dbspace. 


* LOCK DBSPACE ... IN EXCLUSIVE MODE will acquire a Z lock on the 
dbspace. 


* LOCK TABLE ... IN EXCLUSIVE MODE will acquire a Z lock on the table and 
an IX lock on the dbspace. 


* For non-read-only DML statements, Z locks will be acquired during index 
page splitting. No operations can read the index while it is being split. 


* When long fields are updated or deleted, a temporary Z lock will be acquired 
on the row or page. This means that even if you are accessing the data with 
isolation level UR, you will not be able to read this data until these 
operations have completed. 


Some SHOW LOCK operator commands have been modified to display the two 
new lock modes. The following commands are affected: 


SHOW LOCK DBSPACE New columns have been added for the new lock 
modes. 


SHOW LOCK GRAPH The new lock modes will appear under the REQ 
MODE column. 


SHOW LOCK USER New columns have been added for the new lock 
modes. 


SHOW LOCK WANTLOCK The new lock modes will appear under the REQUEST 
MODE column. 


3.1.2.1 Example 1 

These tests were done on a dbspace defined with page level locking. Data was 
selected from the same table with three different isolation levels. In this 
example, ELRES1 is issuing the SELECT statement shown in Figure 11. 


ЕЕ * FROM SQLDBA.ITEM WITH UR | 


Figure 11. SELECT Statement with UR Isolation Level 
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I ID I NAME I PRICE 


10 CERTPJUFMNNIIAF 96.52 
* END OF RESULT *** 1 ROWS DISPLAYED ***COST ESTIMATE IS 4%***%*%*%%%*%%%%% 


Figure 12. Output from SELECT with UR Isolation Level 


p 
SQLOP SHOW LOCK USER 
DBSPACE LOCK NUMBER 
AGENT USER NUMBER TYPE IN SIX IS IX 65 U X 7 WAITERS 
1 ELRES3 DB 0 0 0 1 0 0 0 0 0 
2 ELRES1 DB 0 0 0 1 0 0 0 0 0 
2 ELRES1 1 DBSP 0 0 1 0 0 0 0 0 0 
2 ELRES1 1 IKEY 0 0 0 0 5 0 0 0 0 
2 ELRES1 1 ROW 0 0 0 0 8 0 0 0 0 
2 ELRES1 1 TABL 0 0 7 0 0 0 0 0 0 
2 ELRES1 51 DBSP 1 0 0 0 0 0 0 0 0 
2 ELRES1 51 TABL 1 0 0 0 0 0 0 0 0 
ARIOO65I SQL/DS operator command processing is complete. 


EE 


Figure 13. Output from SHOW LOCK USER with UR Isolation Level 


DBSPACE 10СК NUMBER 
NUMBER ТҮРЕ IN SIX IS IX S U X Z WAITERS 
51 DBSP 1 0 0 0 0 0 0 0 0 
51 TABL 1 0 0 0 0 0 0 0 0 


ARIOO65I SQL/DS operator command processing is complete. 


Figure 14. Output from SHOW LOCK DBSPACE 51 with UR Isolation Level 


ЕЕ * FROM SQLDBA.ITEM WITH RR 


Figure 15. SELECT Statement with RR Isolation Level 


DBSPACE 10СК NUMBER 
NUMBER ТҮРЕ IN SIX IS IX $ U X 7 WAITERS 
51 DBSP 0 0 1 0 0 0 0 0 0 

51 PAGE 0 0 0 0 1 0 0 0 0 

51 TABL 0 0 0 0 1 0 0 0 0 


ARIOO65I SQL/DS operator command processing is complete. 


Figure 16. Output from SHOW LOCK DBSPACE 51 with RR Isolation Level 
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БЕ * FROM SQLDBA.ITEM WITH CS | 


Figure 17. SELECT Statement with CS Isolation Level 


DBSPACE 10СК NUMBER 
NUMBER ТҮРЕ IN SIX IS IX $ U X 7 WAITERS 
51 DBSP 0 0 1 0 0 0 0 0 0 

51 PAGE 0 0 0 0 1 0 0 0 0 

51 TABL 0 0 1 0 0 0 0 0 0 


ARIOO65I SQL/DS operator command processing is complete. 


Figure 18. Output from SHOW LOCK DBSPACE 51 with CS Isolation Level 


3.1.2.2 Example 2 

In this example, one row of the ITEM table was updated by agent 1, then the 
change was rolled back, while agent 2 tried to select this data using both RR and 
UR isolation levels. The original value of I PRICE is 96.52. 


UPDATE SQLDBA.ITEM SET I PRICE - 53.12 WHERE I ID-10 
CP SLEEP 3 


ROLLBACK WORK 


Figure 19. SQL UPDATE Statement from Agent 1 


This update statement was run by ELRES1 against the ITEM table. A second 
user, ELRES3, attempted to run the following query and was put in LOCK WAIT. 
Since no WITH parameter was given, default is isolation level RR. 


БЕ * FROM SQLDBA.ITEM WHERE I ID-10 | 


Figure 20. SQL SELECT Statement from Agent 2 
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- 


SHOW LOCK USER 
DBSPACE LOCK NUMBER 

AGENT USER NUMBER TYPE IN SIX IS ІХ 65 U X 7 WAITERS 

1 ELRES1 DB 0 0 0 1 0 0 0 0 0 

1} ELRES1 1 DBSP 0 0 1 0 0 0 0 0 0 

1 ELRES1 1 IKEY 0 0 0 0 6 0 0 0 0 

1 ELRES1 1 ROW 0 0 0 0 8 0 0 0 0 

1 ELRES1 1 TABL 0 0 8 0 0 0 0 0 0 

1 ELRES1 51 DBSP 0 0 0 1 0 0 0 0 0 

1 ELRES1 51 PAGE 0 0 0 0 0 0 1 0 0 

1 ELRES1 51 TABL 0 1 0 0 0 0 0 0 1 

2 ELRES3 DB 0 0 0 1 0 0 0 0 0 

2 ELRES3 1 DBSP 0 0 1 0 0 0 0 0 0 

2 ELRES3 1 IKEY 0 0 0 0 5 0 0 0 0 

2 ELRES3 1 ROW 0 0 0 0 8 0 0 0 0 

2 ELRES3 1 TABL 0 0 7 0 0 0 0 0 0 

2 ELRES3 51 DBSP 0 0 1 0 0 0 0 0 0 
АВ100651 SQL/DS OPERATOR COMMAND PROCESSING IS COMPLETE. 


Figure 21. SHOW LOCK USER Shows Agent 2 in LOCK WAIT 


The select statement was changed to use isolation level UR. 


ЕЕ * FROM SQLDBA.ITEM WHERE I ID-10 WITH UR 


Figure 22. SQL SELECT Statement with UR Option from Agent 2 


This select statement had the following result: 


I ID I NAME I PRICE 


10 CERTPJUFMNNIIAF 53.12 
* END OF RESULT *** 1 ROWS DISPLAYED ***COST ESTIMATE IS 4%**%%*%*%%%*%%%%% 


Figure 23. Result of SELECT with UR Isolation Level 


Running either statement after the ROLLBACK WORK returned the following 
data: 


I ID I NAME I PRICE 


10 CERTPJUFMNNIIAF 96.52 
* END OF RESULT *** 1 ROWS DISPLAYED ***COST ESTIMATE IS 4%**%*%*%*%%%*%*%%%% 


Figure 24. Output from SELECT after ROLLBACK WORK 


3.1.2.3 Usage 

Applications using isolation level UR will perform less locking than other 
applications. It may be appropriate to review the NLRBS and NLRBU startup 
parameters if a database will support mainly query applications using isolation 
level UR, as each agent will require fewer LRBs. 
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Note: Using the isolation level UR will not completely eliminate lock contention. 
Operations using this isolation level still need to wait for objects being 
processed under Z mode (see above). Deadlocks are still possible. 


3.2 VSE Extended User Buffering 


3.2.1 Usage 


Previous releases of DB2 Server for VSE wrote а single 4K data page per call to 
VSAM. Now, multiple pages can be blocked into а single call to VSAM. VSAM 
then attempts to use as few real l/Os as possible to write the pages to DASD. 
This uses the new Extended User Buffering support provided by VSE/VSAM. 


А Request Parameter List (RPL) is а VSAM control block used by VSAM to 
perform an I/O. These can be chained together to request multiple pages to be 
read or written in а single call to VSAM. Each real agent will be allocated an 
extra set of RPLs when blocking data page writes. 


This enhancement will save physical I/Os by blocking together page writes in a 
single call to VSAM. The performance improvements will be most obvious during 
data loading operations and sorts, joins and view materializations where internal 
dbspace pages are written to DASD. 


This enhancement is similar to the multi-block BLOCKIO support introduced for 
VM in SQL/DS V3R1, which allows multiple І/О requests to be blocked together. 


Compared to SQL/DS V3.5, we experienced reductions of elapsed time in the 
area of 1596 (DATALOAD) and 25% (DBSU RELOAD), and nearly no changes 
during CREATE INDEX and REORGANIZE INDEX. These numbers might differ in 
your environment. For more details, refer to Appendix A, "Base Environment 
Overview" on page 195. 


There are no parameters or options to be set to implement this, but the following 
APARs must be installed: 


e АРАН DY44327 on VSE/ESA V2.1 (for VSAM). 


e Ап АРАН on DB2 for VSE & VM V5.1 (APAR PQxxxxx) which had not yet been 
opened at the time of writing this document. 


* АРАН DY43652 must be applied to VSE/ESA Version 2 Release 1.1 to enable 
Extended User Buffering support. This is included in VSE/ESA Version 2 
Release 1.2. or higher. 


More virtual storage will be required to hold the extra set of RPLs used in this 
enhancement. This storage is about: 

e In MUM: NCUSERS * (52-4) * (Max(NPAGBUF,NDIRBUF) * 10%) 

* In SUM: NCUSERS * (52+4) * (Max(NPAGBUF,NDIRBUF) * 50%) 


Generally, the total of this is around 196 (or even below) of the virtual storage 
required for the database partition. 
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3.2.1.1 Example 


In our test environment we had the following initialization parameters: 
* NCUSERS=10 
* NPAGBUF=100 
* NDIRBUF=300 


Storage required for the extra RPLs is: 
* In MUM = 10 * (52+4) * (Max(100,300) * 10%) = 16800bytes 
* In SUM = 1 * (52«4) * (Max(100,300) * 50%) = 8400bytes 


3.3 Year 2000 Support 


36 


The TOD (Time of Day) Clock is used by System/390, and is usually set by the 
system operator on both VM and VSE. It is used for all date and time values in 
DB2 Server for VSE & VM including accounting, log and trace records and 
CURRENT DATE, TIME and TIMESTAMP values. The clock value of zero 
represents January 1, 1900 and its period is about 142 years. This means that it 
will wrap back to zero in 2042. The conversion of the TOD value to date/time 
assumes that years with a value less than 43 are in the 21st century. 


DB2 Server for VSE & VM is not affected by Year 2000 problems, as it uses the 
TOD clock. There are some areas where two-digit year dates are used: 


* General usage of dates 
* Filtered log recovery 
* Trace formatter 


In these areas, it is assumed that a year less than 43 is in the 215! century. This 
is not a problem because there are no existing records with dates earlier than 
1943. 


Due to the way the trace formatter compares dates in the trace records, it will 
not be possible to select a date range that crosses the century. Trace files that 
span the century must be formatted with two executions of the trace formatter. 
This does not mean a new restriction because the same restriction currently 
exists for time ranges spanning midnight. 


Accounting records have been changed to include the century. This gives users 
plenty of time before the turn of the century to adjust their accounting 
procedures. The change is transparent for user-written applications, because the 
century data is being placed in a previously reserved field in the accounting 
record. See the DB2 for VM System Administration manual for details. 


If date fields are defined as DATE, TIME or TIMESTAMP data types, you are safe 
as described above. Whereas if date fields have been defined as integer or 
character, the date may not be in the correct format. The application defining the 
date may need to be changed if the date is being stored with a two-digit year 
instead of a four-digit year. This can involve substantial rework of application 
code, data and possibly DB2 table definitions. It is suggested that future 
applications be designed using the DATE data type for date fields. 
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3.4 LTIMEOUT Initialization Parameter 


3.4.1 Usage 


LTIMEOUT is а new startup parameter that allows а period of time to be defined 
before а LOCK WAIT will timeout. A non-zero lock timeout value will cause any 
agents waiting for a lock to have their current LUW rolled back when the lock 
timeout period has expired. The agent will get an SQLCODE -911. A reason code 
will be returned to indicate whether the SQLCODE -911 was a result of a 
deadlock or lock timeout. Reason code 2 indicates a deadlock and reason code 
68 is given for a lock timeout. 


A zero LTIMEOUT value means there is no timeout, which means locks are 
waiting with the timeout capability switched off. This is the default. 


Setting LTIMEOUT can improve performance in applications where lock 
contention has begun to affect performance and concurrency levels. 


LTIMEOUT should be set where DB2 Server for VSE & VM is being used for 
Distributed Unit of Work (DUOW). It is the way to avoid global deadlocks for 
DUOW applications. 


This new parameter is available in both VM and VSE. 


LTIMEOUT is an initialization parameter and is set before starting the database. 
It can also be set with the new online SET command from the operator console. 
The period is specified in seconds and has a range of 0 to 99,999 seconds, which 
is around 27.8 hours. 


The lock timeout period begins when an agent requests a lock. If a user is in 
LOCK WAIT and the LTIMEOUT period is changed, the user will receive a 
timeout if they have been in LOCK WAIT longer than the new LTIMEOUT period. 
Their LUW will be rolled back. 


um > 


ARIO5O03E AN SQL ERROR HAS OCCURRED. 
THE CURRENT LOGICAL UNIT OF WORK WAS ROLLED BACK 
BECAUSE OF A DEADLOCK OR TIMEOUT. IT WAS WAITING 
FOR A TABLE LOCK IN DBSPACE = 51 
HELD BY USER ELRES1. REASON CODE = 68. 
АК105051 SQLCODE = -911 SQLSTATE = 40001 ROWCOUNT = 0 
АК105041 SQLERRP: ARIXRSS SQLERRD1: -110 SQLERRD2: -99 
ARI0502I FOLLOWING SQL WARNING CONDITIONS ENCOUNTERED: 
IMPLICIT ROLLBACK 


ARI7021E SQL/DS HAS ISSUED A ROLLBACK STATEMENT. 
ALL WORK ENTERED FOR SQL/DS PROCESSING SINCE 
THE LAST COMMIT STATEMENT WAS ROLLED BACK. 
YOU MAY HAVE TO REENTER SOME STATEMENTS. 


Figure 25. SQLCODE -911 Returned when a Lock Timeout Occurs 


LTIMEOUT has been added to the list of parameters from the COUNTER 
command as shown in Figure 26 on page 38. The LTIMEOUT counter can also 
be RESET. 
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"am I 
SQLOP COUNTER * 
Counter values at DATE="02-12-97"  TIME="16:19:23" 
Calls to RDS RDSCALL : 99 
Calls to DBSS DBSSCALL: 748 
LUWs started BEGINLUW: 31 
LUWs rolled back ROLLBACK: 10 
System checkpoints taken CHKPOINT: 1 
Maximum locks exceeded LOCKLMT : 0 
Lock escalations ESCALATE: 0 
Waits for lock WAITLOCK: 0 
Deadlocks detected DEADLCK : 0 
Looks in page buffer LPAGBUFF: 1611 
DBSPACE page reads PAGEREAD: 138 
DBSPACE page writes PAGWRITE: 28 
Looks in directory buffer LDIRBUFF: 276 
Directory block reads DIRREAD : 438 
Directory block writes DIRWRITE: 113 
Log page reads LOGREAD : 10 
Log page writes LOGWRITE: 3 
Total DASD reads DASDREAD: 586 
Total DASD writes DASDWRIT: 144 
Total DASD 1/0 DASDIO : 730 
Lock timeouts detected LTIMEOUT: 1 
ARIOO65I SQL/DS operator command processing is complete. 
Figure 26. Output from COUNTER * Using RXSQLOP 
3.5 DSPSTATS Initialization Parameter 
DSPSTATS represents two new initialization parameters. Both are also 
supported in single user mode. The positional parameters control respectively: 
* checkpoint performance information 
* shutdown counter information 
If only one parameter is given, it is taken to be control checkpoint performance 
data, whereas the shutdown counter information setting remains unaffected. It is 


not possible to set shutdown counter information and leave checkpoint 
performance information unaffected. The latter is set although it may be the 


same value as before. 


3.5.1 Checkpoint Performance Information 


The first parameter indicates whether (and how) checkpoint performance 


information is displayed. If only one parameter is given, it is understood to be 


this one. 


“0” means that no checkpoint performance information is displayed, as in 


previous releases. 


“1” means that for each checkpoint a message is given showing that a 
checkpoint has occurred, and the point in time of checkpoint scheduling, 


start, and end. 
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ARI2052I A checkpoint was taken. 
Scheduled: 17:54:27 Started: 17:54:27 Ended: 17:54:27 


Figure 27. Checkpoint Performance Information, Format 1 


* By checking the scheduled timestamp you can get a feeling for how often 
a checkpoint is required. 

* |f the start time is significantly later than the scheduling, it had to wait for 
an LUW to finish. 

* If the end timestamp is significantly later than the start, the checkpoint 
must have had a lot of work to do. This causes users to wait. Response 
time is perceived to be slow. 


“2” means that in addition to the information given with “1”: 


F^ > 


ARI2052I A checkpoint was taken. Туре = Periodic 
Scheduled: 18:05:31 Started: 18:05:31 Ended: 18:05:31 
DIRREAD = 0 DIRWRITE = 8 


PAGEREAD = 0 PAGWRITE = 0 
DSREAD = 0 DSWRITE = 0 
Time spent waiting to start: 0.002 seconds 
Time spent executing: 0.115 seconds 


Log pages filled since last checkpoint: 0 


Figure 28. Checkpoint Performance Information, Format 2 


* The type of the checkpoint is given. 

* The number of directory reads and writes that were required by the 
checkpoint processing is given. DIRREAD, DIRWRITE, PAGEREAD and 
PAGWRITE counters are saved at checkpoint start, and at the end the 
difference is displayed. If dataspace support is installed (on VM only), 
dataspace reads and writes are also displayed. This gives an indication 
of how much work the checkpoint had to do. 

* The number of log pages written is given as an indication of why the 
checkpoint occurred. If the number of log pages written is close to the 
CHKINTVL value, then the checkpoint was done because the CHKINTVL 
value was reached. If the number of log pages written is less than 
CHKINTVL, the checkpoint was scheduled for some other reason. This 
could be because of a DROP DBSPACE command or a commit of an 
update to a non-recoverable storage pool, for example. See the 
Performance Tuning Handbook (SC09-2402-00) for a complete list of when 
checkpoints occur. 


This information offers a much better idea whether checkpoints are taken too 
often or too seldom, and thus helps in performance tuning. 


Note: Avoid displaying checkpoint performance data constantly because it takes 
resources in itself. The DSPSTATS setting can be changed while the 
database is running. 
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3.5.2 Shutdown Counter Information 


The second parameter, if given, indicates whether shutdown counter information 
is displayed or not. 


0 means no display as in previous releases. 


1 means, that a "COUNTER "" operator command is performed at shutdown 
time, be it an SQLEND or an abnormal end, even in single user mode. If 
dataspaces support is active “COUNTER POOL *” is performed also. 


This information is helpful because it gives you the counter information of the 
very end of the database manager. 


3.6 SHOW Initialization Parameters 


3.6.1 Usage 


Startup parameters can now be viewed using the new operator command SHOW 
INITPARM. Previously, these parameters could not be viewed from the database. 
They are stored in a file on the DB2 Server machine, and access to this file was 
required to determine which parameters were in effect. 


SHOW INITPARM can be issued from the operator console, an ISQL session or 
by using the RXSQLOP EXEC. 


»»—SHOW INITPARM >< 


Figure 29. Syntax of the SHOW INITPARM Operator Command 


Initialization parameters at 1997-02-12 15:03:33 


AMODE 31 DUALLOG N PROTOCOL SQLDS 
SYNCPNT N ACCOUNT М DBMODE G 
DUMPTYPE F LOGMODE Y STARTUP W 
SYSMODE M EXTEND N CHARNAME INTERNATIONAL 
DBNAME ELDB2B RESID ELDB2B 
PARMID ELDB2B TRACDBSS 00000000000 | TRACDSC 00 
TRACRDS 0000000 TRACCONV 0 TRACSTG 0 
TRACEBUF 0 ARCHPCT 80 CHKINTVL 100 
NCSCANS 30 NCUSERS 10 NDIRBUF 300 
NLRBS 20000 NLRBU 5000 NPACKAGE 10 
NPACKPCT 30 NPAGBUF 100 SLOGCUSH 90 
SOSLEVEL 10 DISPBIAS 7 LTIMEOUT 0 


DSPSTATS 00 


ARIOO65I SQL/DS operator command processing is complete. 


Figure 30. Output from SHOW INITPARM Using RXSQLOP 


This command is available in both VM and VSE. 
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3.7 SET Initialization Parameters 


3.7.1 Usage 


Some initialization parameters can now be dynamically modified from the 
operator console. The startup parameters CHKINTVL, DISPBIAS, DSPSTATS, 
DUMPTYPE, and LTIMEOUT can be changed using the new SET command. 
Previously, initialization parameters could only be changed at database startup. 


SET commands can be issued from the operator console only. 


pe—SET——CHKINTVL+—newval >< 
HDISPBIAS 
[-DSPSTATS-] 
HDUMPTYPE 
L-LTIMEOUT— 


Figure 31. Syntax of the SET Operator Command 


set ltimeout 15 
ARIOO65I SQL/DS operator command processing is complete. 


set chkintvil 50 
ARIOO65I SQL/DS operator command processing is complete. 


Figure 32. Example of the SET Command 


Modifying CHKINTVL can assist in performance tuning of the DB2 Server. 
CHKINTVL is the maximum number of log pages written before a checkpoint 
occurs. Setting the CHKINTVL value higher will allow performance critical 
applications to take advantage of a larger gap between checkpoints, improving 
performance. When these applications are complete, the CHKINTVL value can be 
reset. 


Changing DISPBIAS levels will allow the dispatcher to behave more like a 
priority dispatcher, or like a round-robin dispatcher. This could be used to 
manage different system loads. 


Changing the DSPSTATS parameters can help to take a snapshot of checkpoint 
processing without having to spend the resources to run it all the time the 
database manager is up. Likewise, it is helpful to be able to turn on the final 
counter information if you detect the need for it while the database is running. 


Changing the DUMPTYPE level will allow different levels of information to be 
captured for any problems that occur. This may be useful if a problem occurs 
and N (None) or P (Partial) has been specified and an F (Full) dump is 
necessary. 


Modifying LTIMEOUT can improve performance in applications where lock 
contention has begun to affect performance and concurrency levels: It could 
initially be set to the maximum time a user wishes to wait for a lock, and tuned 
based on performance and concurrency levels. 
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This command is available in both VM and VSE. 


3.8 COMMITCOUNT on RELOAD 


3.8.1 Usage 


Previously, large RELOAD operations had to be run in single user mode with 
LOGMODE=N to avoid а log full condition. With the addition of a 
COMMITCOUNT parameter, these RELOAD operations can be run in multi-user 
mode, with LOGMODE=Y. The maximum value allowed on the COMMITCOUNT 
parameter is 2 147 483 647. The DATALOAD COMMITCOUNT limit has also 
been increased from 50 000 to 2 147 483 647. 


Another parameter added in this enhancement is RESTARTCOUNT. If there is an 
error during RELOAD, previously the entire table would be rolled back. Now, with 
the COMMITCOUNT, many rows may have been committed already, and if there 
is an error, RESTARTCOUNT can be used to restart the RELOAD at а specified 
number of rows. 


The RELOAD DBSPACE statement has been enhanced to allow the specification 
of RESTARTTABLE. This will easily allow the restart of a RELOAD DBSPAGE, that 
has ended abnormally. This can only be specified if the original RELOAD 
DBSPACE statement included the COMMITCOUNT parameter. 


This enhancement increases the availability of the database by reducing the 
number of operations that must be run in SUM, and reduces the time required 
for table maintenance. It will also reduce the time required to recover from 
errors during the RELOAD operation. 


This enhancement is available in both VM and VSE. 


RELOAD TABLE and RELOAD DBSPACE statements have been enhanced to 
include the COMMITCOUNT and RESTARTCOUNT parameters. RELOAD 
DBSPACE also has a RESTARTTABLE parameter. 


3.8.1.1 RELOAD TABLE 


r—— reload table 
»»—RELOAD TABLE— (table-name) —-PURGE | » 
L-NEW—(dbspace-name)— 
» r—INFILE— (ddname) » 


T 
—INTABLE— (table-name)— 


» >< 


T T T T 
—COMMITCOUNT—(ccount)— ^ —RESTARTCOUNT—(rcount)— 


Figure 33. Syntax of the DBSU RELOAD TABLE Command 


NEW(dbspace-name) 
The following changes have been made to this parameter. 


If the RESTARTCOUNT parameter appears on the RELOAD TABLE 
command, the NEW parameter will not cause the table to be created. 
The RESTARTCOUNT parameter indicates that the RELOAD TABLE 
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operation is being restarted; therefore, NEW processing must have 
already occurred, so it is not required to create the table again. 


PURGE 
The following changes have been made to this parameter. 


If the RESTARTCOUNT parameter appears on the RELOAD TABLE 
command, the PURGE parameter will not cause all rows to be deleted. 
The RESTARTCOUNT parameter indicates that the RELOAD TABLE 
operation is being restarted; therefore, PURGE processing must have 
already occurred, so it is not required to delete all rows from the table 
again. 


COMMITCOUNT(ccount) 


identifies the frequency of COMMIT action during RELOAD processing. 
ccount is а number from 1 to 2 147 483 647 indicating that а COMMIT 
statement should be executed after the number of input table rows equal 
to ccount are processed by RELOAD TABLE. 


Database Services Utility AUTOCOMMIT ON processing must be in effect 
when you use RELOAD COMMITCOUNT processing. If AUTOCOMMIT is 
OFF and the COMMITCOUNT parameter is used, an error message is 
issued. RELOAD command processing is not performed. 


If an invalid ccount value is specified, an error message is written, and 
RELOAD command processing is not performed. 


RESTARTCOUNT(rcount) 


identifies the restart point for RELOAD processing. rcount is a number 
from 1 to 2 147 483 647 that indicates the number of input table rows to 
be skipped before RELOAD command processing begins. Row rcount+1 
will be the first row to be reloaded. 


If RESTARTCOUNT is omitted, no rows are skipped and RELOAD 
processing begins with the first input row. 


If an invalid rcount value is specified, an error message is written, and 
RELOAD command processing is not performed. 


If an end-of-table condition occurs before rcount rows are read from the 
input UNLOAD file, an error message is written to the message file 
before RELOAD processing ends. 


Example 


The following example shows the use of the new parameters of the RELOAD 
TABLE statement. RELOAD TABLE was run with the COMMITCOUNT parameter. 
During the job, the database was shutdown causing the job to fail part way 
through processing. The DBSU input and listing files are shown. 


RELOAD TABLE(SQLDBA.ITEM) NEW(DSITEM) 
INFILE(DBSFILE) COMMITCOUNT (10000) 


Figure 34. DBSU Input file for RELOAD TABLE with COMMITCOUNT 
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lARIO8O1I DBS Utility started: 02/13/97 13:25:29. 
AUTOCOMMIT = OFF ERRORMODE = OFF 
ISOLATION LEVEL = REPEATABLE READ 
0------ » RELOAD TABLE(SQLDBA.ITEM) NEW(DSITEM) 
------ » INFILE(DBSFILE) COMMITCOUNT (10000) 
ARI0852I RELOAD TABLE processing started. 
ARIO8681 DNAME-DBSFILE RECFM-VBS RECSZ-32768 BLKSIZE-32000 
ARIO879I Table SQLDBA.ITEM created. 
ARIO845I Process input table data: SQLDBA.ITEM 
ARIOS8001 ...Begin COMMIT. Input Record Count = 10000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 20000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 30000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 40000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIOS8001 ...Begin COMMIT. Input Record Count = 50000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI0856E The following SQL error and/or warning conditions 
occurred for а DBS-initiated SQL CLOSE INSERT CURSOR statement. 
ARIO503E An SQL error has occurred. 
The current logical unit of work was rolled back, 
and the connection to SQL/DS was severed 
because of operator action. 
ARI0505I SQLCODE = -948 SQLSTATE = 57027 ROWCOUNT = 0 
ARIO504I SQLERRP: ARIRSNDC SQLERRD1: 0 SQLERRD2: 0 
ARI0502I Following SQL warning conditions encountered: 
implicit rollback 


ARI0854E RELOAD SQLDBA.ITEM unsuccessful. 
ARI8998I ...Begin ROLLBACK processing. 
ARI0856E The following SQL error and/or warning conditions 
occurred for a DBS-initiated SQL ROLLBACK WORK statement. 
ARIO503E An SQL error has occurred. 
The SQL statement was not processed 
because the application server ELDB2B 
was not ready or was not found. 
ARI0505I SQLCODE = -940 SQLSTATE = 42705 ROWCOUNT = 0 
ARIO504I SQLERRP: ARIRCONC SQLERRD1: 0 SQLERRD2: 0 
OARIO813I ...Suspend command execution: 
AUTOCOMMIT = OFF ERRORMODE = ON 
ARI0802I End of command file input. 
ARIO807E ...Errors occurred during command processing. 
ARI0808I DBS processing completed: 02/13/97 13:26:50. 


Figure 35. Listing File from RELOAD TABLE with COMMITCOUNT Parameter 
The database was then started again and the RELOAD TABLE job restarted with 
the RESTARTCOUNT parameter. 


RELOAD TABLE(SQLDBA.ITEM) NEW(DSITEM) 
INFILE(DBSFILE) COMMITCOUNT (10000) 
RESTARTCOUNT (50000) 


Figure 36. DBSU Input File for RELOAD TABLE with RESTARTCOUNT 
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1ARI0801I DBS Utility started: 02/13/97 13:29:04. 
AUTOCOMMIT = OFF ERRORMODE = OFF 
ISOLATION LEVEL = REPEATABLE READ 

0------ > RELOAD TABLE(SQLDBA.ITEM) NEW(DSITEM) 

------ > INFILE(DBSFILE) COMMITCOUNT(10000) 

------ > RESTARTCOUNT (50000) 

ARI0852I RELOAD TABLE processing started. 

ARIO8681 DNAME-DBSFILE RECFM=VBS RECSZ-32768 BLKSIZE=32000 
ARI0845I Process input table data: SQLDBA.ITEM 

ARI0843I Restart processing at input data record = 50001. 
ARIO800I ...Begin COMMIT. Input Record Count = 60000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 70000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 80000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 90000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI08751 50000 rows loaded into table SQLDBA.ITEM. 
ARIO800I ...Begin COMMIT. Input Record Count = 100000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI8996I ...Begin UPDATE STATISTICS for SQLDBA.ITEM. 
ARI0853I RELOAD SQLDBA.ITEM successful. 

ARI0802I End of command file input. 

ARI8997I ...Begin COMMIT processing. 

ARIO811I ...COMMIT of any database changes successful. 
ARIO809I ...No errors occurred during command processing. 
ARI0808I DBS processing completed: 02/13/97 13:29:56. 


Figure 37. Listing File from RELOAD TABLE with RESTARTCOUNT 


3.8.1.2 RELOAD DBSPACE 


r—— reload dbspace 


»»—RELOAD DBSPACE—(dbspace-name)——PURGE4—INFILE—( ddname )— ——* 
L-NEW— 


pg Tr] Т > 
—COMMITCOUNT— (ccount)—  '—RESTARTTABLE—(table-name)— 


T T 
—RESTARTCOUNT— (rcount)— 


Figure 38. Syntax of the DBSU RELOAD DBSPACE Command 


NEW(dbspace-name) 
The following changes have been made to this parameter. 


If either the RESTARTCOUNT or RESTARTTABLE parameters appear on 
the RELOAD DBSPACE command, the NEW parameter will not cause the 
restart table to be created. The RESTARTCOUNT and RESTARTTABLE 
parameters indicate that the RELOAD DBSPACE operation is being 
restarted; therefore, NEW processing must have already occurred, so it is 
not required to create the restart table again. 


Note: NEW processing is performed on all tables to be reloaded before 
any rows are reloaded to any table. This means that NEW 
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processing will have already occurred for all tables to be 
reloaded. 


PURGE 


The following changes have been made to this parameter. 


If either the RESTARTCOUNT or RESTARTTABLE parameters appear on 
the RELOAD DBSPACE command, the PURGE parameter will not cause 
all rows of the restart table to be deleted. The RESTARTCOUNT and 
RESTARTTABLE parameters indicate that the RELOAD DBSPACE 
operation is being restarted; therefore, PURGE processing must have 
already occurred, so it is not required to delete all rows from the restart 
table again. 


Note: PURGE processing is performed on all tables to be reloaded 
before any rows are reloaded to any table. This means that 
PURGE processing will have already occurred for all tables to be 
reloaded. 


COMMITCOUNT(ccount) 


See 3.8.1.1, "RELOAD TABLE" on page 42 for details of COMMITCOUNT. 
A COMMIT statement will also be executed after the last row of each 
table has been reloaded. 


RESTARTTABLE(table-name) 


identifies at which table the RELOAD DBSPACE processing will be 
restarted. If a RELOAD DBSPACE operation ended abnormally, and the 
RELOAD DBSPACE statement included the COMMITCOUNT parameter, 
the RELOAD DBSPACE operation can be restarted by using the 
RESTARTTABLE and RESTARTCOUNT parameters. table-name identifies 
the table for which RELOAD processing should be restarted. 


If RESTARTTABLE is omitted, RELOAD DBSPACE processing will begin 
reloading the first table, and the RESTARTCOUNT parameter, if specified, 
will apply to the first table. 


If table-name does not exist in the input UNLOAD file, an error message 
is written and RELOAD command processing is not performed. 


If the table does not exist in the database when RELOAD DBSPAGE with 
RESTARTCOUNT or RESTARTTABLE is issued, an error message will be 
displayed. 


RESTARTCOUNT(rcount) 


See 3.8.1.1, “RELOAD TABLE" on page 42 for details on the 
RESTARTCOUNT parameter. 


Example 


The following example shows the use of the new parameters of the RELOAD 
DBSPACE statement. RELOAD DBSPACE was run with the COMMITCOUNT 
parameter. During the job, the database was shutdown causing the job to fail 
part way through processing. The DBSU input and listing files are shown. 
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RELOAD DBSPACE(PUBLIC.DBSP1) PURGE INFILE(DBSFILE) 
COMMITCOUNT (10000) 


Figure 39. DBSU Input File for RELOAD DBSPACE with COMMITCOUNT 
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- 


1АВ108011 DBS Utility started: 02/13/97 14:05:49. 
AUTOCOMMIT = OFF ERRORMODE = OFF 
ISOLATION LEVEL = REPEATABLE READ 
0------ » RELOAD DBSPACE(PUBLIC.DBSP1) PURGE INFILE(DBSFILE) 
------ » COMMITCOUNT (10000) 
ARI0852I RELOAD DBSPACE processing started. 
ARIO8681 DNAME-DBSFILE RECFM-VBS RECSZ-32768 BLKSIZE=32000 
ARIO8801 10000 rows deleted from table SQLDBA.DRIVER TABLE. 
ARIO880I 100000 rows deleted from table SQLDBA.ITEMI. 
ARIO845I Process input table data: SQLDBA.DRIVER TABLE 
ARIO845I Process input table data: SQLDBA.ITEMI 
ARI89811 Dynamic statistic accumulation was disallowed 
for table SQLDBA.DRIVER TABLE. 
Reason Code - 02 
ARI0875I 10000 rows loaded into table SQLDBA.DRIVER TABLE. 
ARIO800I ...Begin COMMIT. Input Record Count = 10000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI89811 Dynamic statistic accumulation was disallowed 
for table SQLDBA.ITEMI. 
Reason Code = 02 
ARIO800I ...Begin COMMIT. Input Record Count = 10000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIOS8001 ...Begin COMMIT. Input Record Count = 20000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 30000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 40000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 50000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO856E The following SQL error and/or warning conditions 
occurred for a DBS-initiated SQL EXECUTE INSERT statement. 
ARIO503E An SQL error has occurred. 
The current logical unit of work was rolled back, 
and the connection to SQL/DS was severed 
because of operator action. 
ARI0505I SQLCODE = -948 SQLSTATE = 57027 ROWCOUNT = 0 
ARIO504I SQLERRP: ARIRSNDC SQLERRD1: 0 SQLERRD2: 0 
ARI0502I Following SQL warning conditions encountered: 
implicit rollback 


ARI0854E RELOAD PUBLIC.DBSP1 unsuccessful. 
ARI8998I ...Begin ROLLBACK processing. 
ARI0856E The following SQL error and/or warning conditions 
occurred for a DBS-initiated SQL ROLLBACK WORK statement. 
ARIO503E An SQL error has occurred. 
The SQL statement was not processed 
because the application server ELDB2B 
was not ready or was not found. 
ARI0505I SQLCODE = -940 SQLSTATE = 42705 ROWCOUNT = 0 
ARIO504I SQLERRP: ARIRCONC SQLERRD1: 0 SQLERRD2: 0 
OARIO813I ...Suspend command execution: 
AUTOCOMMIT = OFF ERRORMODE = ON 
ARI0802I End of command file input. 
ARIO807E ...Errors occurred during command processing. 
ARIO808I DBS processing completed: 02/13/97 14:08:22. 


Figure 40. Listing File for RELOAD DBSPACE with COMMITCOUNT 


The database was then started again and the RELOAD DBSPACE job restarted 
with the RESTARTTABLE and RESTARTCOUNT parameters. 
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RELOAD DBSPACE(PUBLIC.DBSP1) PURGE INFILE(DBSFILE) 
COMMITCOUNT (10000) RESTARTTABLE (SQLDBA. I TEM1) 
RESTARTCOUNT (50000) 


Figure 41. DBSU Input File for RELOAD DBSPACE with RESTARTTABLE 


- 


1АВ108011 DBS Utility started: 02/13/97 14:11:00. 
AUTOCOMMIT = OFF ERRORMODE - OFF 
ISOLATION LEVEL = REPEATABLE READ 

0------ » RELOAD DBSPACE(PUBLIC.DBSP1) PURGE INFILE(DBSFILE) 
------ > COMMITCOUNT(10000) RESTARTTABLE (SQLDBA. ІТЕМ1) 
------ » RESTARTCOUNT (50000) 

ARI0852I RELOAD DBSPACE processing started. 

ARIO8681 DNAME-DBSFILE RECFM-VBS RECSZ=32768 BLKSIZE=32000 
ARIO846I Ignore input table data: SQLDBA.DRIVER TABLE 
ARIO845I Process input table data: SQLDBA.ITEMI 

ARI0843I Restart processing at input data record = 50001. 
ARIO800I ...Begin COMMIT. Input Record Count = 60000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 70000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 80000. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 90000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI0875I 50000 rows loaded into table SQLDBA.ITEMI. 
ARIO800I ...Begin COMMIT. Input Record Count = 100000. 
ARIO811I ...COMMIT of any database changes successful. 
ARI8996I ...Begin UPDATE STATISTICS for SQLDBA.ITEMI. 
ARI0853I RELOAD PUBLIC.DBSP1 successful. 

ARI0802I End of command file input. 

ARI8997I ...Begin COMMIT processing. 

ARIO811I ...COMMIT of any database changes successful. 
ARIO809I ...No errors occurred during command processing. 
ARIOS808I DBS processing completed: 02/13/97 14:11:59. 


Figure 42. Listing File for RELOAD DBSPACE with RESTARTTABLE 


3.8.1.3 RELOAD with PURGE 
The RELOAD NEW processing works in the following sequence: 


1. Create the table. 
2. Insert all rows. 


3. Update statistics. 
Issue COMMIT WORK. 


The RELOAD PURGE processing works in the following sequence: 


1. Drop indexes, keys and so on. 
Delete all rows. 


2. Insert all rows. 
Update statistics, if dynamic accumulation is allowed. 


3. Re-create indexes, keys and so on. 
Update statistics, if dynamic accumulation is disallowed. 
Issue COMMIT WORK. 
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This is true for both RELOAD TABLE and RELOAD DBSPACE. In the case of 
RELOAD DBSPACE, step 1 is completed for all tables, before step 2 is begun. 
Similarly, step 2 is completed for all tables, before step 3 is begun. 


In the case of RELOAD PURGE COMMITCOUNT, during step 1 the objects that 
are being deleted are written with message ARI8034l to indicate how to re-create 
them later. For example, for a table with only a cluster index, the sequence is 
message AR180351 identifying the clustering index name, then message АҺ180341 
how to re-create it, 


ARI8034I CREATE INDEX ”LANGE”.”LANGEI” ON ”LANGE”.”LAB2TABLE” ("LINE NO” 
ASC ) PCTFREE = 010 


Figure 43. ARI80341l Message 
before message АҺ18016І is issued saying that dropping it was successful. 


r—— Important ... Important 


If the RELOAD is interrupted and has to be restarted, the objects deleted 
during step 1 cannot be re-created again. They have to be created manually 
after the restart has been completed successfully, using the messages 
described above. 


This is true for both, RELOAD TABLE and RELOAD DBSPACE, with the 
PURGE parameter. 
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ARIO801I DBS Utility started: 06/10/97 13:04:22. 
AUTOCOMMIT = OFF ERRORMODE = OFF 
ISOLATION LEVEL = REPEATABLE READ 
------ > SET AUTOCOMMIT ON; 
ARIO815I ...AUTOCOMMIT Processing Mode = ON 
ARI8997I ...Begin COMMIT processing. 
ARIO811I ...COMMIT of any database changes successful. 
------ > CONNECT “LANGE ” IDENTIFIED BY ********; 
ARI80041 User LANGE connected to server SQLVSEOL. 
ARIQ500I SQL processing was successful. 
ARIO505I SQLCODE = 0 SQLSTATE = 00000 ROWCOUNT = 0 
------ > RELOAD TABLE (LAB2TABLE) PURGE 
------ > INFILE (SAVE BLKSZ(2048) PDEV(DASD)) 
------ > COMMITCOUNT (50) ; 
ARI0852I RELOAD TABLE processing started. 
ARIO8681 DNAME-SAVE RECFM-SB RECSZ-2044 BLKSIZE-2048 
ARI8035I The clustering index for LANGE.LAB2TABLE 
is INDEX LANGE.LANGEI 
ARI8034I CREATE INDEX ”LANGE”.”LANGEI” ON "LANGE"."LAB2TABLE" ("LINE NO” 
ASC ) PCTFREE - 010 
ARI8016I DROP INDEX ”LANGE”.”LANGEI” successful. 
ARIO880I 1629 rows deleted from table LANGE.LAB2TABLE. 
ARIO845I Process input table data: DB2LAB.LAB2TABLE 
ARI89811 Dynamic statistic accumulation was disallowed 
for table LANGE.LAB2TABLE. 
Reason Code - 02 
ARIO800I ...Begin COMMIT. Input Record Count = 50. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 100. 
ARIO811I ...COMMIT of any database changes successful. 
aa ACEC SE рр ss Are «тақта 
ARIO800I ...Begin COMMIT. Input Record Count = 1550. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO800I ...Begin COMMIT. Input Record Count = 1600. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO875I 1629 rows loaded into table LANGE.LAB2TABLE. 
ARIO800I ...Begin COMMIT. Input Record Count = 1629. 
ARIO811I ...COMMIT of any database changes successful. 
ARI80161 CREATE INDEX "LANGE"."LANGEI^ ON "LANGE"."LAB2TABLE"(^LINE NO” 
ASC ) PCTFREE = 010 successful. 
ARI8997I ...Begin COMMIT processing. 
ARIO811I ...COMMIT of any database changes successful. 
ARI8996I ...Begin UPDATE STATISTICS for LANGE.LAB2TABLE. 
ARI8997I ...Begin COMMIT processing. 
ARIO811I ...COMMIT of any database changes successful. 
ARI08531 RELOAD LANGE.LAB2TABLE successful. 
ARI0802I End of command file input. 
ARIO809I ...No errors occurred during command processing. 
ARI0808I DBS processing completed: 06/10/97 13:04:24. 
15551 LAST RETURN CODE WAS 0000 
EOJ DB2RELO1 MAX.RETURN CODE-0000 
*PARTIAL END PRINT 


Figure 44. Listing File for RELOAD TABLE PURGE with Drop and Re-create Index 
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3.9 New COBOL Preprocessor Option COBRC 


3.9.1 Purpose 


Some COBOL programs finish with strange, non-zero return codes when they 
access DB2 databases. The results of the EXEC SQL statement are returned in 
the SQLCA and not in register 15, on the other hand register 15 might contain 
residual values erroneously interpreted as a return code when the program 
completes. This may cause problems when, based upon the return code of the 
program, the decision has to be made whether another program can be 
executed or not. 


3.9.2 Description 


3.9.3 Usage 


The COBRC preprocessor option causes an extra COBOL statement to be 
generated for every SQL call. Whenever 


CALL ARIPRDI 
is generated, the 


MOVE ZERO TO RETURN-CODE 


statement is generated immediately following it. 


RETURN-CODE is a COBOL special register, existing in COBOL II and COBOL for 
VSE, and COBOL for VM (the Language Environment (LE) COBOL compilers). 


Since this special register does not exist in older COBOL compilers, the use of 
this new preprocessor option with older compilers can lead to a compile error, 
unless the user has defined a variable called RETURN-CODE himself. 


Use it if you get the return code problem described above, for example due to a 
migration from an old COBOL compiler to COBOL for VSE. 


Do not use it, if: 
* Your COBOL compiler does not support the RETURN-CODE special register. 


* Your application sets the RETURN-CODE special register. For example, the 
following sequence of commands 


MOVE 4 TO RETURN-CODE. 
EXEC SQL SELECT * FROM TABLE. 


will end with RETURN-CODE 0 and not 4 as expected if COBRC is used, 
because EXEC SQL will be replaced with 


CALL ARIPRDI 
MOVE ZERO TO RETURN-CODE. 


3.10 Data Restore - Storage Pool Level Recovery 


The Data Restore feature has been enhanced to allow partial recovery of a 
database at the storage pool level. 


A hard crash is usually the result of DASD failure, and results in a physical loss 
of data. To recover from a hard crash, the DASD device needs to be replaced, 
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then data recovered from a DB2 archive, Data Restore feature BACKUP or user 
archive. 


Currently, to recover from а hard crash in а DB2 database, the entire database 
needs to be restored from an archive. After the restore, the log is analyzed, and 
current operations redone. The database may have many DASD devices, of 
which only one has failed, but the entire database must still be restored. 
Storage pool level recovery (SPLR) requires only the restoration of the damaged 
storage pools instead of the entire database. The restore set for the archive to 
initiate SPLR must include the database archive, all log archives since the 
database archive, if LOGMODE=L, and the current log. If any of these are 
unavailable and a restore is attempted, the database would be in an inconsistent 
state at the conclusion of SPLR. The Data Restore feature will not allow SPLR, if 
the current log is unavailable. A pool that has been defined non-recoverable 
cannot be restored using SPLR. 


This enhancement is available in both VM and VSE. 


For a detailed discussion of recovery strategy, refer to the redbook DB2 
Recovery on VM & VSE Using the Data Restore Feature, SG24-2039-00. 


3.10.1 SHOWPOOL 


The following SHOWPOOL command has been added to the Data Restore 
feature. It will produce a report listing the dbextents and the storage pools to 
which they belong. Dbextents are minidisks in VM, or VSAM clusters in VSE. 


»»— SHOWPOOL >< 


Figure 45. Syntax for the Data Restore Feature SHOWPOOL Command 
This report can be run when the database is either online or offline. 


The report will show the dbextent numbers, the pool to which that dbextent 
belongs and whether that pool is recoverable. 


CONTROL BASE=ELDB2A 
SHOWPOOL 


Figure 46. SHOWPOOL SYSIN for VM 


/**/ 

” SET EMSG ON’ 

”FILEDEF SYSIN DISK SHOWPOOL SYSIN А 
^FILEDEF SYSPRINT DISK SHOWPOOL  SYSPRINT A' 
^XEDIT SHOWPOOL SYSIN А” 

^ XTS91001' 

Exit rc 


Figure 47. SHOWPOOL EXEC for VM 
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XTS9-143 
XTS9-143 
XTS9-143 
XTS9-196 
XTS9-406 
XTS9-403 
XTS9-100 
XTS9-313 
XTS9-143 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-203 
XTS9-143 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-204 
XTS9-143 
XTS9-007 


CONTROL BASE-ELDB2A 

SHOWPOOL 

/% 

Do уои want to continue the SHOWPOOL process ? 
Enter O(CANCEL) or 1(CONTINUE) 

Reply is 1 

Data restore feature version 4.1.0 

DB2 for VSE and VM Version 4 processed 


kkkkxkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Pool= 1 First dbextent= 1 Pool is RECOVERABLE 
Pool= 2 First dbextent= 2 Pool is RECOVERABLE 
Pool= 3 First dbextent= 3 Pool is RECOVERABLE 
Pool= 4 First dbextent= 4 Pool is RECOVERABLE 
Pool= 5 First dbextent= 5 Pool is RECOVERABLE 
Pool= 6 First dbextent= 6 Pool is RECOVERABLE 
Pool= 7 First dbextent= 9 Pool is RECOVERABLE 
Pool= 8 First dbextent= 10 Pool is RECOVERABLE 
Pool= 9 First dbextent= 11 Pool is RECOVERABLE 
Pool= 10 First dbextent= 14 Pool is RECOVERABLE 
Pool= 11 First dbextent= 15 Pool is RECOVERABLE 
Pool= 12 First dbextent= 18 Pool is RECOVERABLE 
Pool= 13 First dbextent= 21 Pool is RECOVERABLE 
Pool= 14 First dbextent= 24 Pool is RECOVERABLE 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
Dbextent= 1 Pool= 1 Next dbextent=NONE 

Dbextent= 2 Pool= 2 Next dbextent=NONE 

Dbextent= 3 Pool= 3 Next dbextent=NONE 

Dbextent= 4 Pool= 4 Next dbextent=NONE 

Dbextent= 5 Pool= 5 Next dbextent=NONE 

Dbextent= 6 Pool= 6 Next dbextent= 7 

Dbextent= 7 Pool= 6 Next dbextent= 8 

Dbextent= 8 Pool= 6 Next dbextent=NONE 

Dbextent= 9 Pool= 7 Next dbextent=NONE 

Dbextent= 10 Pool= 8 Next dbextent=NONE 

Dbextent= 11 Pool= 9 Next dbextent= 12 

Dbextent= 12 Pool= 9 Next dbextent= 13 

Dbextent= 13 Pool= 9 Next dbextent=NONE 

Dbextent= 14 Pool= 10 Next dbextent=NONE 

Dbextent= 15 Pool= 11 Next dbextent= 16 

Dbextent= 16 Pool= 11 Next dbextent= 17 

Dbextent= 17 Pool= 11 Next dbextent=NONE 

Dbextent= 18 Pool= 12 Next dbextent= 19 

Dbextent= 19 Pool= 12 Next dbextent- 20 

Dbextent= 20 Pool= 12 Next dbextent=NONE 

Dbextent= 21 Pool= 13 Next dbextent- 22 

Dbextent= 22 Pool= 13 Next dbextent= 23 

Dbextent= 23 Pool= 13 Next dbextent=NONE 

Dbextent= 24 Pool= 14 Next dbextent= 25 

Dbextent= 25 Pool= 14 Next dbextent= 26 

Dbextent= 26 Pool= 14 Next dbextent=NONE 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Processing successfully completed 


Figure 48. SHOWPOOL SYSPRINT Results from SHOWPOOL on VM 
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3.10.2 RESTORE 


The RESTORE command has been enhanced to allow the specification of the 
pool to restore. 


r— DR restore 

ALL | 

»»—RESTORE— | >< 
[-P00L-—nn | 
| > | | 
—PO0L-—( 52 Loj 

Note: 

1 A maximum of 10 storage pools may be specified. 


Figure 49. Syntax for the Data Restore Feature RESTORE Command 


ALL 
The entire database will be restored. This is the default. 
POOL= 
The specified storage pool(s) will be restored. 
To complete SPLR, the database must be started with STARTUP=U. This will 
allow the database to bring the storage pool up to date with the remainder of the 
database. After the RESTORE POOL is completed and before the subsequent 


STARTUP=U is done, the database will prevent startup if the following database 
startup modes are used: 


STARTUP=L (coldlog) 

STARTUP=E (add DBEXTENT) 

STARTUP:zI (reorganize system catalog indexes) 
STARTUP=M (database migration) 

STARTUP=S (add DBSPACES) 

STARTUP=W (warmstart) 


Furthermore, directory expansion will not proceed until after SPLR is completed 
by the use of STARTUP=U. 


3.10.3 Usage 


To use SPLR, there are two phases: 


1. The first is running the RESTORE command of the Data Restore feature to 
recover the directory and affected dbextents. 


2. The second is the log recovery, where the database manager uses the log 
archives and the current log to bring the storage pool up to date with the 
rest of the database. 


A maximum of 10 storage pools can be recovered. If more than 10 pools need to 
be restored, a full database restore must be done. 


SPLR can only be run if all of the following conditions are fulfilled: 


* The database is running with LOGMODE=L or LOGMODE=A. 
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* The storage pool requiring recovery has been defined as recoverable. 
* The current log is available. 
* The log continuity has not been broken (for example, by a coldlog). 


* A database archive restore set is available. This can be the last database 
archive tape (for LOGMODE=A), or any database archive tape plus the log 
archives (for LOGMODE=L). The database archives can be either a 
translated DB2 archive or a Data Restore feature BACKUP. 


The following steps must be done for SPLR: 


1. Run the SHOWPOOL command to determine which pools require restoring. 
This step is optional. 


2. Replace all damaged DASD and format the disks. 


* In VM, use the CMS FORMAT and RESERVE commands. 
* |n VSE, use the Data Restore feature FORMAT function. 


3. Run RESTORE, specifying the pool(s) to recover. 

4. Start the database with the STARTUP=U parameter, to initiate log recovery. 
If the second phase of SPLR, STARTUP=U, cannot be successfully completed 
(for example, the current log is damaged, an archive log tape cannot be found), 


the only available option is to restore the complete database from a database 
archive (using STARTUP=U or STARTUP=R). 


3.11 


3.11 
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Control Center for VSE & VM 


SQL Master for VSE & VM has been renamed to Control Center and is now an 
optional feature of DB2 Server for VSE & VM Version 5 Release 1. 


The new functions added to Control Center for VSE & VM include the following: 
* Group Authorization Tool 
* Data Restore Interface (VM) 
e Database Monitors (VSE) 
* Package Management Tool (VSE) 
e YEAR 2000 Support 


The information which follows in this section highlights the new functions 
included with Control Center for VSE & VM. For detailed information about these 
new tools, refer to the appropriate Control Center Installation and Operations 
Guide. 


.1 Group Authorization Tool 


The Group Authorization Tool, included in Control Center for VSE & VM, assists 
DBAs in managing the access to database objects. It simplifies the process of 
authorization, and shortens the amount of time needed to grant or revoke 
privileges. The Group Authorization Tool gives DBAs the ability to issue 
authorizations to groups of users on groups of objects rather than one by one. 
Individual users can be associated with defined User Groups; and database 
objects (that is, tables, views and packages) can be associated with defined 
Application Groups. Then, GRANTs and REVOKEs can be issued specifying a 
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User Group (grantee) and an Application Group (on objects) using the Group 
Authorization panel interface. 


3.11.2 Data Restore Interface 


Control Center for VM gives users the ability to automate, manage, track, and 
schedule Data Restore functions on one or more DB2 Server for VM databases. 


The Data Restore support will automate control, provide а menu interface with 
scheduling capability, and track and maintain historic information. 


3.11.2.1 Data Restore Functions 
With Control Center, а user can now manage and execute seven Data Restore 
functions: 


* BACKUP 

* RESTORE 

* UNLOAD 

* RELOAD 

* TRANSLATE 
* LISTLOG 

e APPLYLOG 


For additional information on the Control Center Data Restore interface, see DB2 
Server for VSE & VM Archive and Recovery Using the Data Restore Feature, 
SG24-4833-01. 


=: =) 
05.03.1997 Control Center Facility 14.49.25 
*------------------------------- Data Restore Menu ------------------------- * 
| Option ===> CTRLID: ELDBMSRV | 
| Database ---» ELDB2B NODE: ВОЕҮМСТІ | 
| DRMACH: ELDB2DRF | 
| | 
| T TRANSLATE ARCHIVE TRANSLATE archive into BACKUP format | 
| U UNLOAD DBSPACES UNLOAD one or more dbspaces | 
| R RELOAD TABLES RELOAD one or more tables 
| LL LISTLOG LISTLOG selection panel | 
| AL APPLYLOG APPLYLOG selection panel 
| VJ VIEW JOB SCHEDULE VIEW database job schedule | 
| S VIEW DRMACH STATUS VIEW Data Restore Machine status | 
| SR RESET DRMACH STATUS RESET Data Restore Machine status | 
| View Tapes Edit Tapes View History View Log | 
| BACKUP BT BM BH BL | 
| UNLOAD UT UM UH UL | 
| TRANSLATE ТТ TM TH TL | 
| 
| Enter OPTION, select DATABASE, press ENTER to process | 
| RE SDRMAIN----- x 
РЕ: 1 Help 3 End 


Figure 50. Data Restore Menu 
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3.11.3 Monitoring Tools 
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Originally available with Control Center for VM, Control Center for VSE has been 
enhanced to include database monitoring. These tools record database activity 
such as locking or log percent full and provide notification when defined 
threshold values have been exceeded. Monitor information is stored in tables 
that can be viewed on-line or printed in batch reports. 


Each monitor issues а database operator command, captures the output, writes 
information to the appropriate monitor table, and optionally provides notification 
of exceptional conditions where applicable. 
There are seven types of monitors provided: 

* SHOW ACTIVE 

* SHOW CONNECT 

+ SHOW DBEXTENT 

* SHOW DBSPACE 

* SHOW LOCK 

* SHOW LOG 

* COUNTER * 


The SHOW ACTIVE and SHOW CONNECT monitors collect information that 
indicates if users have been waiting for database resources. Using defined 
thresholds, Control Center will send notification if it detects a user in wait state. 


The SHOW LOCK monitor records the number of lock buffers in use and who is 
locking what object. Threshold usage will warn or notify immediately if any kind 
of user locking is detected. 


The SHOW LOG, SHOW DBEXTENT, and SHOW DBSPACE monitors record the 
consumption of these vital database resources. These monitors also include 
notification if values captured exceed threshold specified percentages. 


The COUNTER * monitor records the occurrence of key events and stores this 
information in the database. Additionally, customized queries can be developed 
that track buffer and page usage. 
The monitor utilities include options to: 

e Start and stop monitors 

* List defined monitors 

* Add, modify, delete, and display monitors 

* View monitor data online 

* Reset monitor data 


* Print monitor report 
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3.11.3.1 Monitor Thresholds and VSE Console Messages 

With the exception of SHOW DBSPACE and COUNTERS *, the remaining monitors 
let users specify a threshold where Control Center will generate a VSE console 
message. 


For instance, if a CHECKPOINT or USER WAIT situation is found when the SHOW 
ACTIVE monitor is executed, or if a PERCENT USED value is reached from a 
SHOW LOG or SHOW DBEXTENT monitor, notification will be sent to the VSE 
console. Similarly, if AGENT NOT PROCESSING or INACTIVE is detected by the 
SHOW CONNECT monitor or if the SHOW LOCK monitor detects a locking 
situation, a message will be sent to the VSE/ESA console. 


3.11.4 Package Utility 


Control Center for VSE has been enhanced to include the Package Utility tool 
which automates package management. This new tool lets you unload, reload, 
rebind, and view packages. 


Each package function uses DBSU, where Control Center generates the 
appropriate DBSU commands and includes the JCL to manage their execution. 


With the Unload and Reload utilities, you can also migrate packages from one 
server to another. The Rebind utility includes the option to rebind only those 
packages marked as invalid, while the View Package utility creates a report that 
provides useful tuning information which shows you a program's preprocessing 
options together with each SQL statement used in the program. 


3.11.5 Year 2000 Support 


Control Center for VSE & VM functions support the Year 2000; this includes date 
processing in job scheduling. All dates are displayed with a four-digit year. 


In addition, with Control Center for VM, users may choose the NLS date and time 
format to be used; for example, ISO, USA, EUR, or JIS. 


3.12 Control Center for VSE 


3.12.1 Database 


The following section gives an overview of those Control Center for VSE 
functions that exist already in SQL Master for VSE. A similar tool set is available 
with Control Center for VM. For more details on any of the tools for either 
Control Center component, please refer to the appropriate Control Center 
Installation and Operations Guide. 


Operator Command Interface 


Control Center for VSE gives DBAs the ability to perform DB2 SHOW and 
COUNTER commands against any database connectable from CICS. 


3.12.2 Dbspace Reorganization 


The Dbspace Reorganization Tool includes the following options: 


* Dbspace Reorganization 
* Dbspace Redefinition 

* Dbspace Migration 

* Dbspace Unload/Reload 
* DDL Generation 
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Manual reorganizations, at the dbspace level, execute quickly and save space, 
but require that everything be saved before the dbspace is dropped. Control 
Center generates all the DDL needed to completely recreate the dbspace and 
any dependent objects. Then it unloads, drops, and reacquires the dbspace, 
recreates and reloads all tables, and recreates all indexes, views, and 
comments. After reissuing all authorizations, Control Center optionally rebinds 
all associated packages and updates all statistics. 


The Dbspace Reorganization Tool lets you choose either tape or disk as the 
reorganization media. You can copy or migrate а dbspace to another storage 
pool or database. You can also rename а dbspace, as well as redefine the 
number of dbspace pages, header pages, percent free, percent index, or lock 
level. 


Control Center unloads dbspaces to VSAM or tape where they can be used for 
later reloading. You can also specify а new database name, owner name, or 
dbspace name. When the dbspace is reloaded, it will be placed in the new 
database with the new names you specified. 


Dbspace reloading can also be used to recover from any error that might occur 
during а dbspace reorganization. 


3.12.3 Job Scheduling 


Using time/event scheduling parameters, dbspace reorganizations can be run 
immediately, scheduled at а later date and time, or even scheduled to run 
repeatedly. The single user mode parameters let you specify logmode and the 
number of directory and page buffers you want to use. 


3.12.4 DDL Generation 


By reading the database catalog tables, Control Center is able to generate all of 
the DDL needed to recreate а dbspace. That includes the tables, indexes, views, 
comments, referential constraints, and authorizations. DBSU commands to 
rebind dependent packages are also generated and placed in the VSE/POWER 
punch queue. 


From there, the DDL can be used to create new tables, indexes or views. The 
rebind package statements can be used to show which programs are using 
which objects in the dbspace. 


3.12.5 Dbspace Analysis 


The Control Center Dbspace Analysis Tool evaluates dbspaces, identifying those 
that need dbspace reorganization or update statistics performed. It uses the 
criteria you choose to determine which dbspaces are candidates for 
reorganization, and lets you schedule or immediately execute the necessary 
maintenance. 


3.12.6 CICS Report Controller Interface 
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Control Center interfaces with the CICS Report Controller where you can 
release, delete, change and browse jobs that you have submitted to the 
VSE/POWER queue. 
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Chapter 4. DRDA 1 Client/Server Implementation 


In this chapter we describe our connectivity environment and DRDA installation 
and customization on all the platforms included in our environment. We will end 
this chapter with some security considerations. 


This chapter is intended to take you through all the DRDA and related 
implementation aspects that you need to be aware of while implementing а 
client/server setup including VSE, VM, OS/2, AIX, Windows NT, Windows 95 and 
Windows 3.1 all connected to each other acting either as а server or а client or 
both. 


The chapter is organized as discussed below. 
Connectivity Environment Overview 


In this section the complete environment setup with the different roles each 
machine and operating platform plays is explained with the help of two figures 
which show the system overview and the connectivity overview. For more 
details see 4.1, "Connectivity Environment Overview” on page 62. 


DRDA Function Installation and Customization 


You will be taken through installation and customization step by step on all 
platforms so that you could easily replicate it in your own setup. For details 
refer to 4.2, "DRDA Function Installation and Customization" on page 65. 


VM Installation and Customization 


In this section AVS setup, installation of DRDA code, updating the database 
machine, and finally customization of VM as an application requester are 
presented. VM installation and customization is discussed in detail in 4.2.1, "VM 
Installation and Customization" on page 65. 


VSE Installation and Customization 

Addition of CICS table entries, installation of DRDA code, updating the dbname 
directory and updating the startup job are described. For details see 4.2.2, "VSE 
Installation and Customization" on page 71. 


VTAM Setup 


VTAM definitions are presented here. Refer to 4.2.3, "VTAM Setup" on page 75 
for details. 


OS/2 Customization 
Customization for OS/2 as an AS and AR database server is described and node 


directory configuration in the new version is highlighted. A detailed discussion is 
presented in 4.2.4, “О5/2 Customization" on page 77. 
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AIX Customization 


DRDA connectivity, planning SNA network names, steps in server configuration 
including creation of Data Link Control, SNA profiles and updating the database 
directories are shown. Updating the DB2PROFILE and connecting AIX AR via 
TCP/IP to DDCS server is also explained. AIX customization is presented in 4.2.5, 
"AIX Customization" on page 84. 


Windows NT Platform 


In this section steps such as authorization of users, installation of DB2, getting 
started with DB2 and TCP/IP support are presented. Later in the section 
installation of MS SNA server V3.0 and SNA Server Manager is detailed. 
Definition of APPC-Connection and DB2 directory entries are the last items in 
this section. Windows NT customization is discussed in detail in 4.3.3, "Database 
Connection from Windows/NT to Other Platforms" on page 113. 


4.1 Connectivity Environment Overview 
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The new DB2 Server runs on many different platforms, such as VSE/ESA, 
VM/ESA, OS/2 Warp, Windows NT, AIX, HP-UX and Solaris. 
During this residency we selected the following platforms to explore: 
* Server Environment: 
- VM/ESA V2.1 
— VSE/ESA V2.2.0 
— OS/2 Warp Server V4 
— Windows NT Server V4.0 
— AIX V4.2 
e Client Environment: 
- VM/ESA V2.1 
- OS/2 Warp V4 
— Windows NT Workstation V4.0 
— Windows 95 V4 
— Windows 3.1 
— AIX V4.2 


We chose these different platforms to meet today's customer requirements 
where there are different common workstations, different common servers, 
different enterprise servers and different combinations between servers and 
workstations. 


Based on that we set up DB2 Server to run in such a diversified environment as 
shown in Figure 51 on page 63 (System Overview) and Figure 52 on page 64 
(Connection Overview). 
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УСТСА C22 


Station1 


Station2 


/ Station4 


Figure 51. ITSO Environment - System Overview 


In Figure 51, the setup is presented. We have VM/ESA V2.1 with VTAM 4.2 and 
AVS (APPC/VTAM support) and DB2 Server for VM Version 5 Release 1. On the 
VSE side which is running as a guest operating system we have VSE/ESA V2.2.0, 
VTAM 4.2 with CICS V2.3 and DB2 Server for VSE V5.1. On Station1 we have 
OS/2 WARP server V4 and also OS/2 WARP in a dual boot mode. On Station2 we 
also have OS/2 WARP server V4 and Windows 3.1 client in dual boot mode. 
Station6 is our AIX server V4. Station4 is our Windows/NT server. Station3 is the 
Windows 95 and Windows NT client and Station5 is the AIX client. 


All these workstations and servers are on a Token-Ring LAN at ITSO with a 
bridge to the global token-ring through which it accesses the VM system via a 
3745. 


Note: All the station(n) signify one physical workstation each. 
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SERVER 


VTAM CLIENT VTAM CIOS |DaNAME- 
SA-10 CLIENT SA-122 


APPLID= | seyyseo1 


APPL= 
IP1AITSO |SSCPNAME= CLIENT SSCPNAME-| IP1AMC 
IP1VM DB2 forVSE 


SERVER 
AIX 
SRVAIX 
DDCS/6000 
ОВ? for AIX 


CLIENT 


| | 
05/2 a Vindows9 
DDCS/2 | 
DB2 for OS/2 | T 
SRVOS2 | CLIENT | i 
SERVER Ж NETID=DEIBMIP1 [ткн SEN i 

' © | | CLIENT | | 

Wind Y BOEVMCT1 ' 
indows | | AIX OS/2 WARP СВОЕМ 


DDCS NT 
DB2 for Win NT | . | CLBOEOS1 
RANT | ' | CLBOEAX1 


Figure 52. ITSO Environment - Connection Overview 


Figure 52 describes the DB2 and DRDA connections. VM is acting as а server 
and has a database SRVVMO1, VM also has CMS clients. VSE can only act as a 
DB server, the name of the database is SRVVSE01. We have three universal 
servers AIX, OS/2 and Windows/NT all acting as gateways with Distributed Data 
Connection Services (DDCS) on them. The names of the AIX, OS/2 and 
Windows/NT servers are SRVAIX, SRVOS2 and SRVWNT respectively. In our 
setup we have a Windows 3.1 client (CLBOEW31), a Windows 95 client 
(CLBOEW91), a Windows NT client (CLBOEWN!1), an OS/2 WARP client 
(CLBOEOS1) and an AIX client (CLBOEAX1). 
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4.2 DRDA Function Installation and Customization 


In the following pages we summarize the installation and customization steps for 
DRDA Function in all platforms. 


Detailed information for each platform is described in Appendix B, 
"Client/Server Environment Used” on page 197. 


4.2.1 VM Installation and Customization 


4.2.1.1 Setup AVS Machine for Connection 

AVS (APPC/VTAM support) enables VM applications to access an SNA network. 
It provides the LU (logical unit) function as defined by SNA. An LU is referred to 
as a gateway in the VM environment. AVS runs in a GCS (group control system) 
as a VTAM application. It converts APPC/VM macro calls into APPC/VTAM 
macro calls and vice versa. 


AVS allows DB2 Server for VM requests to be routed between the local VM 
system and remote SNA locations. 


ADD CP directory statements to the AVS machine: The following statements, 
when added to the CP directory of the AVS machine, will allow AVS to handle 
remote communications: 


IUCV ANY allows this AVS to connect to any virtual machine, resource or 
gateway. 


IUCV *IDENT GATEANY GATEWAY REVOKE allows this AVS virtual machine to 
connect to *IDENT (Identify System Service) and identify any gateways that are 
used to access resources in the SNA network. 

Lets this AVS machine identify any gateway name. 


IUCV ALLOW allows any virtual machine to connect through this AVS. 


OPTION COMSRV MAXCONN 20 ACCT MAXCONN nnnnn defines the maximum 
number of IUCV and APPC/VM connections allowed for this AVS. The nnnnn 
value should be large enough to handle all planned APPC/VM paths that start 
from, or end at, your system. You should also consider the number of paths 
other programs in the same VM system may need. COMSRV enables this AVS 
to act as a communication server. The AVS virtual machine can put the user ID 
of the virtual machine that issued the APPCVM CONNECT in the connection 
parameter list. Without this the CP would send the connect with the 
communication server's user ID. ACCT lets the AVS machine generate the 
accounting records. 

(= > 
* 


USER ITSOAVS xxxxxx 32M 64M G 64 
* 


IPL GCSXA PARM AUTOLOG 

IUCV ANY 

IUCV *IDENT GATEANY GATEWAY REVOKE 
IUCV ALLOW 


OPTION COMSRV MAXCONN 20 ACCT 
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Define the AVS gateway to VTAM: Each AVS gateway requires a VTAM APPL 
definition statement to allow VTAM to route communications to that gateway. 
The example below defines the AVS gateway named IP1AITSO as an application 
program major node of VTAM. 


SECACPT-ALREADYV transaction programs can specify any security level 
(SAME, PGM and NONE). ALREADYV is recommended if you are using VTAM 
Version 3 Release 3 or later. Earlier versions of VTAM do not support this option. 
The transaction programs using DRDA however cannot use the NONE option but 
ALREADYV is the only option which lets you specify security level SAME and 
PGM. 


SYNCLVL=SYNCPT allows a partner to enter SYNCPT functions, which is the 
highest level supported on VM/ESA. The SYNCPT functions let the requester 
virtual machine and the AVS synchronize their communications. 


um I 


ITSO VBUILD TYPE=APPL 
* 


IPIAITSO APPL АРРС-ҮЕ5, 
AUTHEXIT=YES, 
AUTOSES=10, 
DLOGMOD=IBMRDB, 
DSESLIM=100, 
DMINWNL-50, 
DMINWNR-50, 
SECACPT-ALREADYV , 
SYNCLVL-SYNCPT, 
PARSESS-YES 


ООо әәә О О О О 


Define the AGWPROF GCS Exec: The AGWPROF GCS exec contains commands 
that are issued when AVS has initialized. This exec can be used to activate the 
AVS global gateway named IP1AITSO, which is defined to VTAM on an APPL 
definition. The GLOBAL operand of the ACTIVATE AVS command indicates that 
the mentioned gateway can be used to allocate conversions with Global 
resources. The alternative is PRIVATE which allows the gateway to be used only 
for private resources of the user ID which is specified with the PRIVATE operand. 


After the gateway has been activated, it can then be used for DRDA 
communications by DB2 for VM requesters accessing remote DRDA servers, or 
remote requesters accessing DB2 for VM servers. 


| “AGW ACTIVATE GATEWAY IPIAITSO GLOBAL’ | 


4.2.1.2 Install DRDA Code 

The ARISDBMA exec is used to enable DB2 for VM DRDA support. The 
parameter ARAS=Y is default and installs both DRDA application server and 
application requester. 


= DRDA (ARAS-Y) | 


Rebuild Database Manager LOADLIB (ARISQLLD LOADLIB): After running 
ARISDBMA, the ARISQLLD LOADLIB must be rebuilt. For information about this 
topic, refer to the "Program Directory for DB2 for VM” Appendix A. 
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CAUTION 


This step has changed!!! In DB2 for VM (SQL/DS) Version 3, the ARISSLKE 


exec was used to rebuild the LOADLIB. However in Version 5 ARISSLKE is 
no longer supported. Instead, VM/SES functions are used. 


In our case MMDB?2 is the name of the product instead of 564815A1 which is the 
default. As we used minidisks, DB2VM was specified. For a shared file system 
DB2VMSFS is specified instead of DB2VM. 


VMFSETUP MMDB2 DB2VM 
VMFBLD PPF MMDB2 DB2VM ARIBLLLD (all 
VMFBLD PPF MMDB2 DB2VM (serviced 


4.2.1.3 Update Database Machine 

Add CP directory statements to the DB2 machine: The following statements, 
when added to the CP directory of the AVS machine, will allow the DB2 for VM 
server to handle remote communications. 


OPTION MAXCONN 150 is defined for maximum connections to this database 
machine. These connections can be local or from other programs in the SNA 
network. 


IUCV *IDENT SRVVMO1 GLOBAL defines the SRVVMO1 database server as a 
global resource, which can be accessed from a remote AR. This name, 
SRRVMO01, should be the same as the dbname on the SQLSTART EXEC. 


С. — 


* 


USER SRVVMOL ххххххх 32М 64M G 
* 


INCLUDE CMSUSER1 

IPL CMS 

IUCV *IDENT SRVVMO1 GLOBAL 
IUCV ALLOW 

MACH XC 

OPTION MAXCON 150 


Update startup parameter: The following startup parameters are used to enable 
DRDA support. 


PROTOCOL=AUTO should be specified for DRDA protocol support. The default 
value is SQLDS which supports VM AR only. 


DB(SRVVMO01) is the name of this database, and is also the RESID (resource ID). 
RESID is the VM term for transaction program name. 
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PARMSTR = "PROTOCOL-AUTO" 

Address "COMMAND" 

"CP SET RUN ON" 

"ACCESS 195 Q" 

"CP TERMINAL LINEND #” 

"CP TERMINAL LINEDEL OFF” 

"CP TERMINAL CHARDEL OFF” 

"CP TERMINAL ESCAPE (^ 

"CP SET EMSG ON^ 

"SET LANGUAGE AMENG (ADD ARI USER” /* @C5050SD*/ 
"EXEC SQLSTART DB(SRVVMO1) PARM(”PARMSTR”)” 


SHOW INITPARM 


After the server has started up, the SHOW INITPARM command can be used to 
check the initial parameters. 


* PROTOCOL AUTO 
* DBNAME SRVVMO1 
e RESID SRVVMO1 


Г: I 
show initparm 
Initialization parameters at 1997-02-28 14:35:44 
AMODE 31 DUALLOG N NETID DEIBMIP1 
PROTOCOL AUTO SYNCPNT Ү ACCOUNT N 
DBMODE 6 DUMPTYPE F LOGMODE Y 
STARTUP W SYSMODE M EXTEND N 
CHARNAME INTERNATIONAL DBNAME — SRVVMO1 
RESID SRVVM01 PARMID TRACDBSS 00000000000 
TRACDRRM 0000 TRACDSC 00 TRACRDS 0000000 
TRACWUM 0 TRACCONV 0 TRACSTG 0 
TRACEBUF 0 ARCHPCT 80 CHKINTVL 10 
NCSCANS 30 NCUSERS 5 NDIRBUF 30 
NLRBS 2520 NLRBU 1000 NPACKAGE 10 
NPACKPCT 30 NPAGBUF 30 SLOGCUSH 90 
SOSLEVEL 10 DISPBIAS 7 LTIMEOUT 0 
ARIOO65I SQL/DS operator command processing is complete. 


4.2.1.4 Customize for AR 


Define CMS COMDIR 


The CMS Communications Directory (COMDIR) is used to provide APPC/VM with 
the information it needs for establishing connections with remote partners. We 
use the COMDIR to define connection information for communicating from VM 
application programs to remote DRDA servers. 


There are two different COMDIR files, one is SCOMDIR for the whole system and 
the other is UCOMDIR for the user only. In the following example, the UCOMDIR 
NAMES file defines two servers: 


. SRVOS21, which is the OS/2 database server 
* SRVVSEO1, which is the DB2 for VSE server 
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— 


:NICK.SRVOS21 


:NICK.SRVVSEO1 


:ТРМ.В0Е052 

: LUNAME.IP1AITSO IP1P10CP 
: MODENAME . I BMRDB 

: SECURITY . PGM 
:USERID.CLBOEVMI 

: PASSWORD . XMAS25MM 

: DBNAME . SRV0S21 

: ТРМ. BOE1 
:LUNAME.IPIAITSO ІРІАМС 
: MODENAME . I BMRDB 

: SECURITY . РСМ 
:USERID.CLBOEVM1 

: PASSWORD . XMAS25MM 

: DBNAME. SRVVSEO1 


Having defined the COMDIR file, we use the following commands to enable the 


COMDIR file: 


SET COMDIR FILE USER UCOMDIR NAMES A 
SET COMDIR RELOAD USER 


DBS Utility and ISQL on DB2/2 Application Server 


Before a user can access the DBS Utility and ISQL at remote DRDA servers, the 
DBSU and ISQL packages must be created at those servers. 


1. Setup for DBS Utility 


* Create required tables on DB2/2 using SQLDBSU.CMD 


CD SQLLIBMISC 
Е SQLDBSU.CMD 
SQLDBSU SRVOS21 


SQLDBSU.CMD should be updated as follows for DB2 Server for VM. 
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- 


db2 create table system.syscatalog 
(tname varchar(18), 
creator char(8), 
creator char(8), 
tabletype char(1), 
ncols smallint, 
remarks varchar(254), 
dbspaceno smallint, 
dbspacename varchar(18), 
tabid smallint, 
clustertype char(1), 
clusterrow smallint, 
avgrowlen smallint, 
rowcount smallint, 
npages smallint, 
pctpages smallint, 
noverflow smallint, 
lfdtabid smallint, 
lfdlink smallint, 
lfddbspace smallint, 
tlabel varchar(30), 
parents smallint, 
dependents smallint, 
inactive smallint, 
datacapture char(1)) 


Preprocess the DBS Utility from the VM AR side 


LINK SRVVMO1 193 193 RR 
ACC 193 V 


SQLPREP ASM PP (PREP-SQLDBA.ARIDSQL, BLOCK, 1501 (CS) , NOPR, NOPU) 


IN (ARIDSQLP MCRO V) 


2. Setup for ISQL 


For information about this topic, refer to DB2 for VM System Aaministration, 
(GC09-2405-00) and VM/ESA V2H1.0 Connectivity, (SC24-5756-00). 


For more details refer also to B.1, "VM Definitions" on page 197. 


DB2 Server VM and VSE V5R1 


Create the required tables on DB2/2 using ISQL.CMD 


CD SQLLIBMISC 
ISQL SRVOS21 


Reload the ISQL package from the VM AR side 


LINK SRVVMO1 193 193 RR 

ACC 193 V 

FILEDEF ARIISQLM DISK ARIISQLM MACRO V 
SQLDBSU IN(SETUP2 DBSU A) 


SETUP2 DBSU A: 


E PACKAGE (SQLDBA.ARIISQL) REPLACE KEEP INFILE(ARIISQLM); 


db2 insert into sqldba.dbsoptions values(’’ RELEASE’’, ^^5.1.0'' 


| 


4.2.2 VSE Installation and Customization 


4.2.2.1 Add CICS Table Entries 


In our case we used the RDO function to install the group name DRDA. 
CEDA ADD GR(DRDA) LIST(VSELIST) 


CEDA 


INSTALL GR(DRDA) 


DEFine TRansaction(RDO) or DFHPCT 


The following transactions were defined for both DRDA and DRDA2 support: 


NAME 
BOE1 
CAXE 
DAXP 
DAXT 


TYPE GROUP 
TRANSACTION DRDA 
TRANSACTION DRDA 
TRANSACTION DRDA 
TRANSACTION DRDA 


TPN transaction for remote AR 
Another TPN for remote access 

DRDA2 Set Parameter Transaction 
DRDA2 Terminate Support Transaction 


BOE1 is the TPN (Transaction Program Name) for remote access to the 
ARICAXED program. This TPN should be defined both here and in the Dbname 


Directory. 

= 
CEDA DEFine 
TRansaction : BOEL 
Group : DRDA 
PROGram : ARICAXED 
TWasize : 00000 
PROFile : DFHCICST 
PArtitionset 
STatus : Enabled 


The transaction CAXE is defined in a similar way as BOE1. 


0-32767 


Enabled | Disabled 


and DAXT are used for DRDA2 support. 


Transactions DAXP 


m 

CEDA DEFine 

TRansaction : CAXE 
Group : DRDA 
PROGram : ARICAXED 
TWasize : 00000 
PROFile : DFHCICST 
PArtitionset 

STatus : Enabled 
PRIMedsize : 00000 
RECOVERY 

DTimout : No 
Indoubt : Backout 
REStart : No 
SPurge : Yes 
TPurge : Yes 

DUmp : Yes 
TRACe : Yes 


0-32767 


Enabled | Disabled 
0-65520 


No | 1-6800 

Backout | Commit | Wait 
No | Yes 

No | Yes 

No | Yes 

Yes | No 

Yes | No 


DEFine PROGram(RDO) or DFHPPT 


The following programs were defined for both DRDA and DRDA2 support: 
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NAME 
ARICAXED 
ARICDAXD 
ARICDEBD 
ARICDIRD 
ARICDRAD 
ARICDR2 


TYPE 

PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 
PROGRAM 


GROUP 


DRDA DRDA Server Support AXE Entry 

DRDA DRDA Server Support DAXP and DAXT Entry 

DRDA DRDA Server Support DRDA TRUE enable Entry 

DRDA DBNAME Directory Service Entries 

DRDA DRDA Server Support DRDA TRUE exit Entry 

DRDA DRDA Server Support DR2DFLT control block Entry 


ARICDIRD is for Dbname Directory service. 


(Ст =) 
CEDA DEFine 
PROGram : ARICDIRD 
Group : DRDA 
Language : Assembler CObol | Assembler | С | Pli | Rpg 
RELoad : No No | Yes 
RESident : No No | Yes 
RS] : 00 0-24 | Public 
Status : Enabled Enabled | Disabled 
The other programs are for DRDA Server support and are defined as 
RESIDENT=YES, for example: 
= =>) 
CEDA DEFine 
PROGram : ARICAXED 
Group : DRDA 
Language : Assembler CObol | Assembler | C | Pli | Rpg 
RELoad : No No | Yes 
RESident Yes No | Yes 
RS] : 00 0-24 | Public 
Status : Enabled Enabled | Disabled 
DEFine Connection and Session or DFHTCT 
The following connections and sessions were used to define LU6.2 connections 
to our remote DRDA requesters: 
Сс I 
NAME TYPE GROUP 
CT10 CONNECTION | DRDA For 0S/2 AR 
CT11 CONNECTION ODRDA For 05/2 AR 
CT12 CONNECTION DRDA For 
CT13 CONNECTION DRDA For Windows/NT AR 
CT14 CONNECTION DRDA For 
CT15 CONNECTION DRDA For AIX AR 
VM01 CONNECTION DRDA For VM AR 
CT10 SESSIONS DRDA For 05/2 AR 
CT11 SESSIONS DRDA For 0$/2 AR 
CT12 SESSIONS DRDA For 
CT13 SESSIONS DRDA For Windows/NT AR 
CT14 SESSIONS DRDA For 
CT15 SESSIONS DRDA For AIX AR 
VM01 SESSIONS DRDA For VM AR 


The first connection and session is provided below. Note the following 


parameter 
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values: 


CONNECTION=CT10 is the name of the connection. 


NETNAME=IP1P10CP identifies the APPN cpname at the OS/2 workstation with 
which the DRDA conversation will take place. Note that when APPN is used, 
only the cpname is required here. If APPN functionality is not being utilized, we 
instead specify an LUNAME valid at the Communications Server for OS/2 on the 
workstation. 


ATTACHSEC=VERIFY means that both user ID and password are required when 
the conversation from OS/2 is established. 


P > 
CEDA DEFine 
Connection : CT10 
Group : DRDA 
CONNECTION IDENTIFIERS 
Netname : ІР1Р10СР 
INDsys 
OPERATIONAL PROPERTIES 
AUtoconnect : Yes No | Yes | All 
INService : Yes Yes | No 
SECURITY 
SEcurityname 
ATtachsec : Verify Local | Identify | Verif 
Bindpassword : PASSWORD NOT SPECIFIED 
(Са EN 
CEDA DEFine 
Sessions : CT10 
Group : DRDA 
SESSION IDENTIFIERS 
Connection : CT10 
SESSName 
NETnameq : 
MOdename : IBMRDB 
DFHSIT 


The System Initialization Parameter Table must be modified for DRDA 
connections. 


APPLID=IP1AMC This is defined in the VTAM APPL major node’s name. This 
name is also defined as the partner LU on the remote AR side. 


ISC=YES This is required for LU6.2 links to CICS ISC. 
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DFHSIT TYPE=CSECT, С 
ABDUMP=NO, CICS SYSDMP ON ASRB TRANS ABENDC 
AKPFREQ-200, ACTIVITY KEYPOINTING FREQUENCY C 
ALT-NO, NO APPLICATION LOAD TABLE C 
AMXT=20, MAX ACTIVE TASKS С 
APPLID=IP1AMC, CICS APPLICATION NAME C 
ISC-YES, INTERSYSTEM COMMUNICATION C 


DFHSNT 


Since we specified ATTACHSEC=VERIFY on the connection definition, we need 
to update the CICS sign-on table with valid USERID and PASSWORD information: 


m I 


DFHSNT TYPE=INITIAL 

DFHSNT TYPE-ENTRY , USERID-CLBOEVMI , PASSWRD-XMAS25MM 
DFHSNT TYPE-ENTRY , USERID-CLBOEVM? , PASSWRD-XMAS25MM 
DFHSNT TYPE-ENTRY , USERID-CLBOEVM3 , PASSWRD-XMAS25MM 


4.2.2.2 Install DRDA Code at the DB2 Server 
The skeleton of the installation’s job is ARIS412D.Z 


=, > 


* $$ JOB JNM=ARIS412D, CLASS=A, DISP=D,NTFY=YES 
* $$ LST CLASS=Q,DISP=H 
// JOB ARIS412D 


Ж kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


* ARIS412D: LINK EDIT RDS WITH DRDA SERVER SUPPORT 
skrekk ee ee КК КККК КККК ККК КККК ККК КК КККК КККК КККК ККК КККК КК 
// LIBDEF *,SEARCH-PRD2.DB2 
// LIBDEF PHASE,CATALOG=PRD2.DB2 
// OPTION CATAL 
INCLUDE ARISLKRA 
// EXEC PGM=LNKEDT,PARM=’ MSHP’ 


4.2.2.3 Update Dbname Directory 

In our case TPN BOE? and DBNAME SRVVSEO1 are defined as defaults. 
TPN BOE7 should be defined as a CICS transaction. 

The following screen shows an excerpt of the Dbname Directory used. 


С > 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
*TPN — APPLID *ОВМАМЕ РММ PRIV @PN42886* 
* 1 1 22 3 44 5 * 
*2..5___0...... NE 9 45 0 * 
BOEL _ SYSARIOL  *SRVVSEOl 
.6DB  SYSARIOO 50105 
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4.2.2.4 Update Startup Job 
DBNAME=SRVVSE01 is the new default name of the database server. 


RMTUSERS=30 should be specified, otherwise the default value is set to 0. 


Ст ae 


* $$ JOB JNM=DB2START,CLASS=4,DISP=L,NTFY=YES 

* $$ LST CLASS=Q,DISP=H 

// JOB DB2START START SQL/DS IN MULTIPLE USER MODE 

// LIBDEF PROC, SEARCH=(PRD2.DB2) 

// EXEC PROC=ARIS41PL *-- SQL/DS PRODUCTION LIBRARY ID PROC 
// EXEC PROC=ARIS41DB *-- SQL/DS DATABASE ID PROC 

// EXEC ARISQLDS,SIZE=AUTO, PARM=" DBNAME-SRVVSEO1, RMTUSERS=30" 


For more information about this topic, refer to DB2 for VSE System 
Administration, GC09-2406-00 and B.2, “VSE Definitions” on page 200. 


DB2 Server for VSE can only be an AS. 
4.2.3 VTAM Setup 


4.2.3.1 APPN Function 
In our environment VM/VTAM is set up as an ICN (Interchange Node) of APPN 
functions. Therefore, we use APPN functions for DRDA connection. 


ICN can act as an NN (Network Node) of APPN and also support traditional SNA 
subarea node functions, NCP becomes a composite node. 


This APPN function offers better performance during session initiation and 
network activation, because APPN uses fewer line flows per LU-LU session and 
some control sessions can be eliminated. 


Another advantage is a reduction in system definitions, because APPN learns 
about the network dynamically. Therefore, some definitions can be eliminated 
(such as the LU definition for CICS, IP1ANG, and the LU definition for the OS/2 
workstation). 


4.2.3.2 VTAM Definition 

In our case the connection route is via Token-Ring LAN and 3745 NCP to the host 
VM/VTAM. VM/VTAM and VSE/VTAM are connected through a virtual channel to 
channel adapter (VCTCA). 


For a DRDA connection we no longer need to define independent LUs as before 
when using the APPN functions. 


Therefore, only the switched major node IP1SW10 VTAMLST is defined for DRDA 
connection. 


АТС5ТН00 VTAMLST 


Some parameters of the VTAM startup should be changed for APPN function 
support. 
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HOSTSA=,NODETYPE=NN parameters are defined for ICN (Interchange Node). 


The following parameters are defined for APPN support: 


* SORDER=SUBAREA 
* NODETYPE=NN 

* APPNCOS=#INTER 
* BN=YES 

* BNDYN=FULL 

* CDSERVER=YES 

* CONNTYPE=APPN 
e CPCP=YES 

e DYNADJCP=YES 


SSCPID=10, 
HOSTPU=IP1PU, 
HOSTSA=10, 
NETID=DEIBMIP1, 
SSCPNAME=IP1, 
MAXSUBA=63, 
IOBUF=(230,182,3,,1,38), 
ІРВЏЕ= (24, ,2,,1,4), 
ІЕВЏЕ=(,,,,1,1), 
CRPLBUF- (400, ,,,1,1), 
SFBUF=(,,,,1,1), 


О О ОО О О О О О О О О О ә ә ә ә ә еә ә ә ә О О О 


SORDER=SUBAREA, SUBAREA WILL BE SEARCHED FIRST VTAM4.2 
NODETYPE=NN, APPN NETWORK NODE VTAM4.2 
APPNCOS=+ INTER, APPN COS-TABLE VTAM4.2 
BN=YES, APPN BORDER NODE FUNCTION VTAM4.2 
BNDYN=FULL, APPN BORDER NODES ADDED VTAM4.2 
CDSERVR=YES, APPN CENTRAL DIRECTORY SERVER — VTAMA.2 
CONNTYPE-APPN, APPN CONNECTION VTAM4.2 
CPCP=YES, VTAM4.2 
ISTCOSDF=ALL, VTAM4.2 
ALSREQ=NO, VTAM4.2 
XNETALS-NO, VTAM4.2 
DYNADJCP=YES, VTAM4.2 
DYNLU=YES, VTAM4.2 


NOTRACE, TYPE=VTAM 


ІРІМСР VTAMLST 


In the NCP definition there are no parameters related to APPN functions that 
have to be defined. 


For dynamic reconfigured independent LUs, NUMILU should be defined in the 
LUDPOOL macro. In our case NUMILU=10 is specified. 


= 

T—(——————————————— IK 

ЕГІ LUDRPOOL kokke 

ska ske aksess ke F K F K FE K GO IGG GO IGG IO IC КККК КККК IC IO II IOI I TOR II I II I AK 

IP1PUDR PUDRPOOL NUMBER=10 

IPILUDR LUDRPOOL NUMTYP2=100, С 
NUMILU=10 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
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IP1SW10 VTAMLST 


In the switched major node for APPN connection, CPNAME should be defined. 
The CPNAME is the control program name. It should be different from the 
PUNAME (Physical Unit Name), for easier problem determination. If no 
dependent LUs for 3270 session are needed, other parameters can be omitted. 


єў bae! 


IPIP10 PU ADDR=01, COULD BE ANYTHING (NOT USED) 
DISCNT=NO, 
CPNAME=IP1P10CP, 
DYNLU=YES, 
MAXDATA=1920, MAXDATE 0$/2 CM (0LD:1033 2/12/92) 
MODETAB=MTD1SERH, 
DLOGMOD=QUERY, 
VPACING=0, 
PUTYPE=2, 
ANS=CONT, 
CONNTYPE=APPN, ALLOWS APPN OR LEN 
USSTAB=USSTERM 


ОО О О ООЭОИОЭОЭО9ЭО 


IP1SW10 VTAMLST 


For our Windows/NT connection using an SNA Server, a cross domain 
majornode is defined, because the SNA Server cannot configure the host as an 
NN. 


p > 


* 


VBUILD TYPE=CDRSC 
DEIBMIP1 NETWORK NETID=DEIBMIP1 
* 


IP1P13CO CDRSC  ALSLIST-(IP1P13CP, IP1P13) ,RESSCB=12, C 
ALSREQ=YES , DLOGMOD- IBMRDB 
ІРІРІЗСІ CDRSC  ALSLIST-(IP1P13CP, IP1P13) ,RESSCB=12, C 


ALSREQ=YES , DLOGMOD- IBMRDB 


* 


Reference manuals are Migrating from VTAM 3.4 to VTAM 4.2 with APPN 
Support for VSE/ESA and VM/ESA, (SG24-4830-00), VTAM 4.2 Implementation and 
Usage for VM/ESA and VSE/ESA, (SG24-4556-00) and Subarea Network to APPN 
Network Migration Experiences, (SG24-4656-00). Refer also to B.3.1, "VTAM 
Definitions" on page 205. 


4.2.4 OS/2 Customization 


4.2.4.1 OS/2 as AS Database Server for OS/2 Warp 
This is one example of setup using our STATION1 on which NETBIOS, TCP/IP 
and APPC protocols were used. 


The customization described here is for an APPC connection between the DB2 
Server for VM and STATION1 AS. 
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Setup for NETBIOS Protocol 
1. OS/2 NETBIOS should be configured in MPTS. 
2. Supply SET DB2COMM=NPIPE,NETBIOS іп CONFIG.SYS. 


3. Set the workstation name (NNAME) in the database manager configuration 
file. 


In our case it's defined using the command line processor command: 
"UPDATE DBM CFG USING NNAME STATION1” 


Setup for TCP/IP Protocol 
1. TCP/IP should be configured in MPTS. 
2. Supply SET DB2COMM=NPIPE,TCPIP in CONFIG.SYS. 
3. Add to the SERVICES file 


db2instlc 3700/%4ср £ DB2 connection service port 
db2instli 3701/%ср # DB2 interrupt connection service port 


4. Set the Service name (SVCNAME) in the database manager configuration 
file. 


In our case it was defined using the command line processor command: 
"UPDATE DBM CFG USING SVCNAME db2instlc" 


Setup for APPC Protocol 
1. IEEE 802.2 should be configured in MPTS. 
2. Supply SET DB2COMMENPIPE,APPC іп CONFIG.SYS. 


3. Communication Server's configuration is required for APPC protocol. To 
connect to a host using DDCS functions, Communication Server or CM/2 
setup is required. 


We set up Communication Server and the following figure shows the 
relationships between the definitions. 


Note that since the other Station DB2 clients use NETBIOS and TCP/IP to 
connect to the same server, this statement would read 
SET DB2COMM=NPIPE,NETBIOS,TCPIP,APPC. 
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DRDA Protocol Setup Relationships 


DB2 for OS/2 Setup 
Node res Comm. Server Setup 


Protocol PP 


Local node name IP1P10CP 


Connection to NN 


LAN destination addres: 400023/00601 
CPIC 


ymbolic destination 
hame 


BO VM 
artner LU DEIBMIP 1.IP 14 О | 


Mode name IBMRDB 


arget DB патер SKVVMU 


DRDA Setup for VM 


Figure 53. APPC Setup for VM 


4. Configure DB2/2 Directory for АРРС. 


Node Directory, Database Directory and DCS Directory should be configured. 
The command for cataloging the node at the command line processor is: 
”CATALOG APPC NODE VMNODE REMOTE BOECTVM SECURITY PROGRAM” 

VMNODE is the name of the node, BOECTVM is the symbolic destination 


name for the REMOTE node, the SECURITY level is PROGRAM which means 
both user ID and password are required. 


The command for cataloging the database at the CLP is: 
"CATALOG DATABASE SRVVMO1 AS SRVVMO1 AT VMNODE AUTHENTICATION DCS” 


SRVVMO1 is the name of the database, its alias is also SRVVMO!1, it resides 
at node VMNODE, and the DCS shows that AUTHENTICATION will take place 
at the node where the database resides. 
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The command for cataloging the DCS database at the CLP is: 
"CATALOG DCS DATABASE SRVVMO1 AS SRVVMO1 PARMS ",SRVVMO1"^ 
SRVVMO01 is the database name, alias is SRVVMO1, and then a parameter 
string is given to be passed to the AR when it is invoked. 
Update Security Set Up 
1. Add user with Userprofile Management 


For AR access to a DB2/2 AS, the user ID should be defined in Userprofile 
Management and the required privilege should be granted. 


2. Update database manager authentication (AUTHENTICATION) in the 
database manager configuration 


For AR access to a DB2/2 AS, the AUTHENTICATION parameter can be 
specified as CLIENT. This means that the authentication of the user will take 
place at the client. The default value is SERVER and for other local clients, 
this is the preferred value. 


"UPDATE DBM CFG USING AUTHENTICATION CLIENT^ 
3. Configure Conversation Security in Communication Server 


Conversation Security should be configured. For the DRDA connection you 
have two options for the SECURITY parameter value: 


* SECURITY = SAME 

— А password is not sent to the DRDA AS. 
* SECURITY = PROGRAM 

— A password is sent to the DRDA AS. 


First go to the Communication Server Setup. After selecting the 
configuration, choose "Communication Manager Profile List" from the pull 
down menu "OPTIONS". Then select "SNA features" and then "Conversation 
security”. In there check the ”Utilize User Profile Management" box. 


4.2.4.2 OS/2 as AR Database Server for OS/2 Warp 
In this example NETBIOS, TCP/IP connection from STATION4 to STATION1, and 
АРРС connection from STATION1 to DB2 Server for VSE are specified. 
Setup for NETBIOS Protocol 
1. OS/2 NETBIOS should be configured in MPTS. 


2. Set the workstation name (NNAME) in the database manager configuration 
file. In our case it's defined using the command line processor command: 


"UPDATE DBM CFG USING NNAME 5ТАТІ0М4”. 


3. Configure the DB2/2 Directory for the client. The Node Directory and 
Database Directory should be configured. 


"CATALOG NETBIOS NODE 0521МЕТ REMOTE STATION1 ADAPTER 0” 
"CATALOG DATABASE SRVOS21 AS OS21NET AT 0521МЕТ” 


Setup for TCP/IP protocol 
1. TCP/IP should be configured in MPTS. 
2. Add to the HOSTS file 
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9.164.148.106 ITSOPS2 # 
3. Add to the SERVICES file 
db2instlc 3700/%4ср # DB2 connection service port 
4. Configure DB2/2 Directory for client. 
Node Directory and Database Directory should be configured. 
"CATALOG TCPIP NODE OS21TCP REMOTE ITSOPS2 SERVER db2instlc^ 
"CATALOG DATABASE SRVOS21 AS 0521ТСР AT 0521ТСР” 
Setup for APPC Protocol 
1. IEEE 802.2 should be configured in MPTS. 
2. Supply SET DB2COMMzNPIPE,APPC іп CONFIG.SYS. 
3. Communication Server's configuration is required for APPC protocol. 


To connect to a host using DDCS functions, Communication Server or CM/2 
setup is required. We set up Communication Server. 


The following figure shows the relationships between the definitions. 


Note that since the other Station DB2 clients use NETBIOS and TCP/IP to 
connect to the same server, this statement would read "SET 
DB2COMM=NPIPE,NETBIOS,TCPIP,APPC.” 
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DRDA Protocol Setup Relationships 


DB2 for OS/2 Setup 

Node Directory Comm. Server Setup 
Local Node 

Node name 

Network ID DEIBMIP 


Protocol 


Local node name ІРІРЛОСР 
Connection to NN 
LAN destination addres! 400023700601  — 


Security type 
DB Directory 


Authentication 


DCS Directory Mode name IBMRDB 


Security PGM 


Target DB name, SRVVSEO1 


VTAM Setup 
DB2 for VSE Setup l ТРТАТМС 


DE 
DBNAM pu Ó 
PN BO 


DRDA Setup for VSE 


Figure 54. APPC Setup for VSE 


4. Configure DB2/2 Directory for APPC. 
Node Directory, Database Directory and DCS Directory should be configured. 
"CATALOG APPC NODE VSENODE REMOTE BOECTVSE SECURITY PROGRAM” 
"CATALOG DATABASE SRVVSEO1 AS SRVVSEO1 AT VSENODE AUTHENTICATION DCS” 
"CATALOG DCS DATABASE SRVVSEO1 AS SRVVSEO1 PARMS ",SRVVSEO1"^ 

Add User with Userprofile Management 


For AR access to a DB2/2 AS, the user ID should be defined in Userprofile 
Management and the required privilege should be granted. 
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4.2.4.3 OS/2 as AS, AR DB2 Universal Database 


In DB2 Universal Database Version 5, the Node Directory Configuration for APPC 


has changed. A new parameter, OSTYPE, should be configured. If we are 
configuring a VSE connection then OSTYPE VSE is used, for example: 


CATALOG APPC NODE VSENODE REMOTE BOECTVSE SECURITY PROGRAM OSTYPE 
VSE 


If we are configuring a VM connection then OSTYPE VM is used, for example: 
CATALOG APPC NODE VMNODE REMOTE BOECTVM SECURITY PROGRAM OSTYPE VM 


To view the node directory and see the OSTYPE parameter, use the following 
command: 


LIST NODE DIRECTORY SHOW DETAIL 


For more information, see the manual /BM Database Server for OS/2 Warp Up 
and Running. 
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4.2.5 AIX Customization 


This section describes the DB2/6000 installation and the requirements for the 
connectivity between AIX and other platforms. For AIX, our scenario is shown in 
Figure 55 which describes the connections between the different clients and 
servers. 


Connectivity Scenario 
DRDA Server VSE 


Server ITSO1 
DRDA 


Client 


TCP/IP 


TCP/IP DRDA 
Server ITSOPS1 


DRDA Server VM 


TCP/IP 


Figure 55. DRDA Connectivity 


According to the connectivity between the client and the local or remote servers 
(ITSO1, ITSOPS1 and ITSOPS3) you have various options to choose the protocol. 
In this example we used TCP/IP and SNA. 


You are forced to use DRDA protocol between the servers ITSO1, ITSOPS1, 
ITSOPS3 and DB2 Servers for VSE & VM. 


4.2.5.1 Planning SNA Network Names 
It is very important to plan the names which will be used in an SNA network in 
advance because: 


* Profiles of the same type must have different names. 


* You have to define several profiles of the same type, especially if you want 
to connect from more than one client. 


* Profile names should reflect their use. 


* |t can be important for troubleshooting. 
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See the table/worksheet for examples within an SNA network. 


~ ^ 
Profile Name Server 
Control Point — ITS01CP - 
SNA DLC Profile ITSO1DLC 
Link Station Profile ITSO1LS 
Mode ITSO1MO 
TPN £1 ITSO1.TP1 
Local Logical Unit ITSO1LLU 
Local Connection ITSO1LC 
Figure 56. Names of the Profiles in our AIX Environment 
The names in this example are a combination of servername (ITSO1) and the 
profile type (CP = Control Point). 
These names are required in the following steps: 
* Create a Data Link Control 
* Create SNA Profiles 
* Update the database manager configuration file 
- ~ 
Attribute Server 
Network Name DEIBMIPI 
Local LU Name ITSO1LU 
Local LU Name alias ITSO1LUA 
Transaction Program ITSO1TPN 
Name 
XID node ID 00000000 


Figure 57. Other Names within the SNA Network 


The names depend on the VTAM definitions which you can obtain from the 
system administrator for the VTAM network. 


4.2.5.2 DB2/6000 Server Configuration 
Before you use the ITSO1 system, you must define a DRDA server and a DDCS 
gateway. 


This definition is an overview of connecting a DB2/6000 environment with a VSE 
and VM database system. 


The following steps are required: 


* Create a Data Link Control 
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* Create SNA Profiles 


* Update the database manager configuration file 


4.2.5.3 Create a Data Link Control 
The Token-Ring Link Station profile associates the link station with either the CP 
of APPN services or a specified PU. 


To configure the Token-Ring Link Station profile, invoke SMIT and select the 
following items: 

1. Links 

2. Token-Ring 

3. Token-Ring Link Station 

4. Add a Profile 


4.2.5.4 Create SNA Server Profiles 
The SNA profiles describe the physical connection between the server and the 
client. 


The following example profile shows a client/server environment for an AIX 
DB2/6000 Server machine using APPC connectivity. 


Step SNA Control Point Profile 


Example: 


"Um = 


Enter : smitty sna 
Configure SNA 
Initial Node Setup 


Chose the DLC type ....... : token ring 
Profile name <itsolcp> 
XID node ID <0000000> 
Network name <deibmip1> 


Control POINT name <ірірі2ср> 


Figure 58. SNA Control Point Profile 
The XID node ID is required to connect а mainframe environment. 
The Network name must be the same on both the server and the client. 


The Control POINT name must be the same on both the server and the client. 
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Step SNA Token-Ring SNA DLC Profile 


Example: 


- 


Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Token-Ring 
Token Ring SNA DLC Profile 
Add а Profile 


Profile name 


Figure 59. SNA DLC Profile 
In our example we use the default par 


Step Token-Ring Link Station Profile 


Example: 


<itsoldlc> 


ameters. 


- 


Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Token-Ring 
Token Ring Link Station Pro 
Add а Profile 


Profile name 
SNA DLC Profile name 


file 


<itsolls> 
<itsoldlc> 


Figure 60. Token-Ring Link Station Profile 


The default parameters may be used. 


Step SNA LU6.2 Mode Profile 


Example: 


- 


smitty sna 
Configure SNA 
Advanced SNA Configuration 
Sessions 
LU6.2 
LU6.2 Mode 
Add а Profile 


Profile name 
Mode name 


<itsolmo> 
<ibmrdb> 


Figure 61. SNA LU6.2 Mode Profile 


The default parameters may be used. 


Exception: 


The MODE name in the profile in this case must be set to IBMRDB. 
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Step SNA LU6.2 TPN Profile 


This profile describes the main transaction program used by DB2/6000 during 
APPC connection. 


Example: 


um FR 


Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Sessions 
LU6.2 
LU6.2 Transaction Program Name (TPN) 
Add а Profile 


Profile name <itsol.tpl> 
TRANSACTION program name <istoltp> 
Full PATH to TPN executable «...... > 


</home/dbadmin1/sqllib/bin/db2acntp> 
MULTIPLE INSTANCES supported <yes> 
User ID <214> 


Figure 62. SNA LU6.2 TPN Profile 
The default parameters may be used. 
Exception: 


The TRANSACTION program name is not related to any other profile and may be 
whatever name you like to use as long as the name is unique. 


The Full Path to TPN executable must be /home/dbadmin1/sgllib/bin/db2acntp. 
The first two directories in the Full Path are the instance owner's home directory 
(/home/dbadmin1). 


The user ID should be set to the AIX uid of the instance owner. This can be 
found in the /etc/passwd file or by running the id command. 


For example by entering: 


Е dbadmin1 | 
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Step SNA LU6.2 Local LU Profile 


Example: 
ag I 
Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Sessions 
LU6.2 
LU6.2 Local Logical Unit Profile 
Add а Profile 
Profile name <itsolllu> 
Local LU name <itsolllu> 
Local alias <itsollla> 
Local LU is dependent <yes> 
Local] LU Address <1> 
Figure 63. SNA LU6.2 Local LU Profile 
Step SNA LU6.2 Partner LU Profile 
Example: 
fe > 


Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Sessions 
LU6.2 
LU6.2 Partner LU Profile 
Add а Profile 


Profile name <itsolplu> 
Fully qualified partner LU — «deibmipl.iplamc» 
Local LU name «itsolllu» 


Link Station Profile name «itsolls» 


Figure 64. SNA LU6.2 Partner LU Profile 
Fully qualified partner LU name is in our case the application id of the CICS at 


VSE. For VM it has to be the application id of the AVS machine. These 
applications are also defined to VTAM and must match. 
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Step SNA LU6.2 Side Information Profile 


Example: 


С. > 


Enter : smitty sna 
Configure SNA 
Advanced SNA Configuration 
Sessions 
LU6.2 
LU6.2 Side Information 
Add а Profile 


Profile name <boectvse> 
Control Point alias «iplpl2cp» 
Partner LU alias or 

Fully qualified partner LU — «deibmipl.iplamc» 
Mode name <ibmrdb> 

Remote transaction (RTPN) <boel> 


kr о о оох д д ддлд ж —_ кж ————— 


Figure 65. SNA LU6.2 Side Information Profile 


Remote transaction name is the remote TP name. In VSE it is the transaction 
BOE1 which is defined to CICS. For а connection to а VM database it has to be 
their RESID. 


After entering or changing values of the SNA profiles you must verify them by 
SMIT. 


4.2.5.5 Update the Database Directories 

Each database which a client is using has to be defined in the database 
management system. Therefore, the database has to be cataloged in the 
database catalog. 


You must specify entries in the following directories to enable the DDCS 
workstation to connect to a DRDA AS: 

* System database directory 

* DCS directory 


* Node directory 
System database directory 


With the command «db2 list database directory» you will see the entries made 
to the system database directory. 


Catalog the database entry for DDCS: 
CATALOG DATABASE sample AS vsample AT NODE tsample AUTHENTICATION 
DCS 

* sample is the real name of the remote database. 

* vsample is the alias name of the remote database. 

• tsample is the remote node on which the database is stored. 


* dcs specifies how authentication will take place for database authentication 
using DDCS. 
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DCS Directory 


The DCS directory contains an entry for each DRDA that can be accessed from 
the workstation. 


With the command «db2 list dcs directory» you will see the entries made to 
the DCS directory. 


Catalog the DCS entry: 


CATALOG DCS DATABASE sample AS srvvse01 
e sample specifies the DCS database name. 
e srvvse01 specifies the real name (RDB NAME) of the target host database. In 
this example it is the VSE database. 


Node Directory 


With the command «db2 list node directory» you will see the entries made to 
the node directory. 


Catalog the node entries: 


CATALOG АРРС NODE tsample REMOTE boectvse 
* tsample specifies the node name. 


* boectvse this name must correspond to the LU 6.2 side information profile 
name. 


4.2.5.6 Update the Database Manager Configuration File 
If you want to connect from DB2/6000 to another DB2 using АРРС, it is necessary 
to update the database manager configuration file. 


"um = 


* Login as instance owner 
<dbadmin1> 


e Update the database manager configuration file by adding the 
transaction program name. 


UPDATE DATABASE MANAGER CONFIGURATION USING tpname itsoltp 
• Stop and start DB2/6000 
* Check the result 

GET DATABASE MANAGER CONFIGURATION 


Figure 66. Change of Database Manager Configuration 


4.2.5.7 Update the DB2PROFILE 

You have to set the DB2COMM environment variable, when you use the APPC 
protocol for connection. DB2COMM specifies which communication protocol will 
be enabled when the database manager is started. This variable is part of the 
DB2PROFILE. 
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e Change the profile in the directory /instowner/sqllib. 
Example: 
/home/dbadmin1/sqllib/db2profile 


e Change the DB2COMM 


Example: 
. DB2COMM-TCPIP, APPC 
. export DB2COMM 


Figure 67. Change of the DB2COMM Environment Variable 


4.2.5.8 AIX Requester via TCP/IP to DDCS Server 
If you have successfully installed the DDCS server, you can connect via TCP/IP 
from а requester to а mainframe database. 


This implementation is very simple. For AIX you need the TCP/IP connection and 
the Client Enabler for DB2. 


To catalog the node entries, you have to enter the following: 


ЕШ: TCPIP NODE tsample REMOTE itsol. | 


Figure 68. Cataloging the Node Entry 


- tsample specifies the node name. 


“ itso? this name must correspond to the /etc/hosts file. 


To catalog the database entries, you have to enter the following: 


CATALOG DATABASE sample AS asample AT NODE tsample 


Figure 69. Cataloging the Database Entry 


* sample specifies the real remote database name. 
* asample specifies the alias name of the database. 


* tsample specifies the node name. 


4.2.5.9 Test the Remote Database Connection 
To test the connection to the remote server enter: 


CONNECT TO alias USER username USING password 


Figure 70. Connecting to a Remote DB2 Database 


Where: 


* alias is the database name at the client and can be different to the database 
name of the server. 
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* username is a valid user name on the server. 
* password is the password for the user on the server. 


* the user must have connect privilege. 


4.3 Windows NT Platform 


The first part of this section guides you through the DB2 installation process on a 
Windows NT server. The second part of this chapter describes the connectivity 
via SNA to a host system. The third part gives an overview of the different kinds 
of database connections. 


1. DB2 for Windows NT customization 
* Authority for DB2 
* Installation of DB2 
* Getting started 
e TCP/IP Support 
* Database connection via TCP/IP 
2. SNA Server for Windows NT 
* Installation of the SNA Server Version 3.0 
* The SNA Server Manager 
* The SNA Server 3270 Connectivity 
* The SNA Server APPC Connection 
* DRDA function of Windows NT 
3. Database connection from Windows NT to other platforms 
* Connection to DB2 VM and DB2 VSE via DRDA 
* Connection to DB2 of OS/2 and DB2/6000 of AIX via TCP/IP 
* Connection to DB2 VM and DB2 VSE via DB2 OS/2 as DB gateway 


4.3.1 DB2 for Windows NT Customization 


This section describes the customization of DB2 for Windows NT and the 
required definitions for DB2 connections via TCP/IP. 


4.3.1.1 Authority for DB2 
User authentication is performed for database connections, and for instance 
level connections to perform administrative operations. 


You must create a user in the SYSADM group to install the product and your 
instance owner. 


Example: dbadmin3 


The DB2 administrator has SYSADM privileges. It must not be the same as the 
Windows NT administrator. 
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4.3.1.2 Installing DB2 
All DB2 products for Windows NT are shipped with а unique license key. Before 


you use DB2 products, you must enter the product license key in the DB2 for 
Windows NT license file. 


Note that before installing DB2 for Windows NT, you must first create a Windows 
NT administrator user ID whose name is eight characters or less in length and 
follows the restrictions of "authorization ids" according to the SQL Reference 
Manual (for example, it cannot start with "SQL"). Then, log on to this user ID 
before beginning the installation. 


During the installation of the first DB2 product, the install program prompts for 
the product license key. 
1. Insert the CD-ROM in the drive. 
2. Use the File Manager to run setup.exe 
<drive>:<path>DISK1\setup.exe 
3. On the Install window, click on continue. 
4. On the Path window, click on continue. 
The default Path is C:\SQLLIB 


5. When installation is successful, shutdown and reboot your system. 


4.3.1.3 Getting Started 

To use DB2, you must be logged on with a valid user name that has the 
appropriate authority level for commands you wish to execute. 

To start the database manager or create the sample database: 


* Log on with an administrator user name. 


Start the database manager. 


Enter «dbstart» 


Start the DB2 for Windows NT security service. 
Enter «NET START DB2NTSECSERVER> 


Create the sample database. 

Enter <db2sampl> 
Now you are ready to use DB2 locally with your choice of: 
— the command line processor 


— your own application 


The DB2 for Windows NT Security Service (DB2NTSCSERVER) provides a 
daemon program named db2sec.exe. This needs to be started on any Windows 
NT machine (client or server) on which a user name/password must be 
validated. 
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4.3.1.4 TCP/IP Support 
TCP/IP is part of the base Windows NT operating system. Ensure that you have 
installed the TCP/IP network software. 


To accept connection requests from clients using TCP/IP, a DB2 server must be 
listening on а port designated to that server. 


The server’s system administrator must define two service name entries using 
two consecutive port numbers for every instance of DB2 on a workstation. 


The service names and associated ports are defined in the <\...\etc\services> 
file at the server. 
* Port n is the main connection port. 


* Port n«1 is the interrupt port. 


Example: 
. db2instlc 3700/tcp 
. db2instli 3701/tcp 


Figure 71. Service Names 
The service name is case sensitive. 


<db2instlc> and «db2instli» are the service name entries for the connection 
port and the interrupt port respectively, 3700 and 3701 are the port numbers, and 
tcp is the protocol. 


The specified service name associated with the main connection port is the 
value for the svcename parameter in the database manager configuration file. 


The configuration file may be updated using the following: 


| db2 update database manager configuration using svcename db2instlc | 


Figure 72. DB2 for Windows NT Configuration File 


To make this change to the configuration file effective, you must stop and restart 
the database manager. 


You have to set the DB2COMM environment variable to ”TCPIP” to enable 
TCP/IP support when a db2start command is issued. The DB2COMM variable 
must be set in the Windows NT system environment (see Figure 89 on 

page 110). 


The IP addresses have to be entered in the hosts file to get mnemonic names for 


the different systems. The definition of the hosts file is in B.6.3, "Windows NT 
System Definitions" on page 254. 
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4.3.1.5 Database Connection via TCP/IP 
To get а database connection to other DB2 databases, you have to define the 
node and the database directory entries of these databases. 


CATALOG TCPIP NODE aixnode REMOTE itsol SERVER db2instlc 
CATALOG TCPIP NODE osnode REMOTE itsps3 SERVER db2instlc 


Figure 73. Node Directory Entries 


The database entries of the DB2 databases to which we want to connect in our 
ITSO environment are given in the following figure: 


CATALOG DATABASE sample AS osample AT NODE osnode AUTHENTICATION SERVER 
CATALOG DATABASE sample AS asample AT NODE aixnode AUTHENTICATION SERVER 
CATALOG DATABASE srvvm01 AS vmsampl AT NODE osnode AUTHENTICATION DCS 

CATALOG DATABASE srvvse0l AS vsesampl AT NODE osnode AUTHENTICATION DCS 


Figure 74. Database Directory Entries 


To connect to the VM and the VSE databases via the OS/2 node, you have to 
define a DRDA connection between the OS/2 DB2 and the VM or VSE database. 
When the DB2 of OS/2 and VM is up, you can connect to the VM database via 
the DB2 of OS/2. You only have to ensure that the user IDs/passwords are 
defined at the connected databases. How to connect to the databases will be 
described later. 


4.3.2 SNA Server for Windows NT 
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To get an SNA connection between the Windows NT and a host system, we must 
install SNA communications software. Two examples are: 


* IBM Communications Server for NT, Version 5.0 
* Microsoft SNA Server Version 3.0, which is part of the "Microsoft BackOffice 
2.5" package 


In this section, we use Microsoft SNA Server. 


In a Windows NT (sub)domain you have to install at least one SNA Server to get 
an SNA connection between all members of the (sub)domain and the host 
system (VM, VSE, OS/390, OS/400). 


4.3.2.1 Installation of the SNA Server Version 3.0 

As "Microsoft SNA Server Version 3.0" is a component of "Microsoft BackOffice 
2.5", you first have to install the BackOffice Environment. There you can call the 
BackOffice Installer from where you can select different components of 
BackOffice for installation. One of these components is the SNA Server Version 
3.0. 


During the installation process of the SNA Server Version 3.0 you will be asked 
about its different services. For the ITSO environment we selected the following: 


1. ODBC-DRDA Driver 

2. Link services 

3. SDK Documentation 

4. HOST security Integration Service 
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ODBC-DRDA Driver provides access to relational data stores on SNA hosts via 
DRDA. 


Link services is the service to support SNA communication adapters 
(Token-Ring/Ethernet). 


SDK Documentation provides information about installation of the SDK 
(Software Developer's Kit) files and the appropriate documentation. 


HOST security Integration Service provides password security integration 
between Windows NT and IBM /390 host or AS/400. 


During the installation process you also have to enter the name of your Windows 
NT domain or subdomain. In the ITSO installation we entered the subdomain 
name /TSOBB. This name will appear as the SNA Server Manager (see 

Figure 76 on page 98). 


After installation of the SNA Server Version 3.0 you have to call the SNA Server 
Manager to customize the SNA environment. 


4.3.2.2 SNA Server Manager 

The SNA Server Manager offers a look and feel consistent with Windows NT 
Explorer. With the SNA Server Manager you can view and manage all the 
workstations, connections, LUs, sessions, users and groups of all SNA 
subdomains within a Windows NT domain. 


You have to start the SNA Server Manager as follows: 


a ae 


START-Button 
- Programs 
- Microsoft SNA Server (Common) 
- Manager 


Figure 75. Startup of the SNA Server Manager 


There you see the following structure of the SNA Server Manager. 
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ITSUBB 


ОМА Servers 


Fools 

Configured Users 
APFC Modes 

CFIC Symbolic Names 
Active Users 

Hast Security Domains 


Figure 76. SNA Server Manager Structure 


SNA Server Manager provides a hierarchical, tree-like view of an SNA Server 
subdomain and all its resources. When you click on an item on the left pane, the 
right pane shows resources available to the item. 


First we have to define the SNA Server, SRVWNT. Therefore, in the right pane we 
have to click on SRVWNT with the right mouse button to get the properties of the 
server. In the ITSO installation we changed the properties to the values in 


Figure 77. 
(cs. LA 
General 
Server Name SRVWNT 
Comment ITSO Windows NT SNA Server 
Network Name DEIBMIP1 


Control Point Name IP1P13CP 


Server Configuration 
Subdomain ITSOBB 
Server Role Primary 
Network Transport TCP/IP 


Figure 77. SNA Server Properties for Windows NT 


Server Name is for information only. The name of the server cannot be changed 
here. 
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Network Name works together with the Control Point Name to identify а system. 
In our case the Network Name is DEIBMIP1. 


Control Point Name is recommended for the server when you use the server for 
incoming calls or for APPC. We use APPC connection. Therefore, we define the 
Control Point Name IP1P13CP. This is the Control Point Name defined in the 
VTAM definitions of the PU. 


Subdomain is in our installation ITSOBB. Each Windows NT domain can contain 
several SNA Server subdomains. Each SNA Server subdomain can contain one 
primary server and up to 14 backup servers. An SNA Server subdomain cannot 
contain members of other Windows NT domains. 


Server Hole whether Primary or Backup Server. The primary server contains the 
domainwide configuration file. The configuration file reflects all SNA Server 
resources in an SNA Server subdomain (LUs, servers, connections, 3270, ...). 
There can be only one primary server in an SNA Server subdomain. A backup 
server is a server on which the configuration file is replicated by the SNA Server 
product. The SNA Server will load the copy of the configuration file located on a 
backup server if the primary server goes down. 


Network Transport is the transport protocol for the network. In our installation it 
is TCP/IP. 


After defining the properties of our SNA Server SRVWNT we have to change the 
Link Service with the following steps: 


1. Click the server SRVWNT with the right mouse button and then select Link 
Service from the Insert menu. 


2. In the Link Service Configuration dialog box select DLC 802.2 Link Service 
and click /nstall. 


3. In the Service Title box you can use the default title or type in your own text 
for the Link Service. 


4. In the Local Service Access Point (SAP) box, type the local SAP (for the SNA 
Server it is always 04). 


After the definition of the Link Service we are able to define the 3270 Emulation 
Sessions. 


4.3.2.3 SNA Server 3270 Connectivity 

Before a user can access the host, you must configure the connection. Once you 
have configured a connection, LUs can be configured for user access. After the 
LUs are configured, they can be assigned to users, groups, workstations and 
printers. 


To give users and groups access to the mainframe, you must carry out the 
following steps: 

1. Create a connection 

2. Add and configure LUs on the connections 
3. Group LUs into pools (optional) 
4 


. Assign the LUs and/or LU pools to users and groups 
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А very helpful and simple way to configure the 3270 Emulation Session is to use 
the 3270 Wizard provided with the SNA Server. The 3270 Wizard is available 
under the Tools menu of the SNA Server Manager (see Figure 78). The wizard 
takes you through each step of configuring connection properties, creating 3270 
display LUs and а pool, assigning the LUs to the LU pool and assigning the LU 
pool to selected users. 


å SNA Servers 
SRVwWMT [Active] 


Mat 


23 Link Services 
j Pools 
А Configured LI sers 
3 АРРС Modes 
3 CPIC Symbolic M ames 
å Active Users 
4 Host Security Domains 


Not 
Mot 


i 
< 
3 Connections «Not In Uses 
£& |P1 [Active] MG «Моп Uses 
<Not се» 
E <Not 
Remote APPC LUs 
à <Not In Use> 
<Not In Use> 
<Not In Use> 
€ 
< 


доз оз оз оз оз 3355 3 зр 
[ 
[г] 
a 
ч 


Figure 78. Calling the Tools at the Mainbar of the $МА Server Manager 


After calling the 3270 Wizard you have to define the parameters which you see in 
Figure 79. 
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SNA Server SRVWNT 

Name ІРІТІ 

Link Service SNADLC1 
Local Node ID 05D 00000 
Network Address 400023700601 
SAP-Address 04 

Base LU Name ІРІТІ 
Starting LU Number 2 

Number of LUs 4 


Figure 79. 3270 Wizard of SNA Server Manager 


After these definitions you are prompted to select the user or group to whom you 
want to grant access rights to the mainframe. You can select the users from а 
list. You can change the domain name to get the user names from other 
domains. 


Connection Name 1Р1Т1 
3270 display LU Names ІРІТ1002, IP1T1003, .. 
Display LU P001 Name ІРІТІ 


Figure 80. 3270 Wizard of SNA Server Manager 


After confirming this screen, you get the following message if the installation is 
correct: 


”The 3270 Emulation Configuration Wizard has successfully configured 
the connection to your mainframe. Please save the new configuration 
and (re)start the SNA Server Service.” 


Every time you change anything in the configuration, the prompt CONFIG LOCK 
appears in the corner of the SNA Server Manager window. Then you have to 
save the configuration before you restart anything. 


The 3270 Emulation Configuration Wizard created the connection IP1T1 and the 
terminal pool IP1T1 with four LUs IP1T1002, IP1T1003, IP1T1004, and IP1T1005. 
You can now change these names and defaults that the Wizard generated for 
you. We changed the terminal LU names from IP1T1002 to IP1T1302, from 
IP1T1003 to IP1T1303 and so on to get the same names as defined in VTAM. We 
also changed the Display Models from Model 2 to Model 3 (32x80) at the pool. 
The connection name was changed to IP1. 


Now you have to (re)start the SNA Server (SRVWNT). You click the server and 
then you click Service at the menu bar. There you have to stop and restart the 
server. The connection will automatically be started. 
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To get a 3270 session you have to open the Tools and select the 3270-Applet. On 
the menu of the 3270-Applet you have to open Session and then select Connect. 
You can also use Autoconnect to get а Session Connection each time you start а 
3270 connection automatically. 


4.3.2.4 SNA Server APPC Connection 

Before we start to define an APPC connection, we want to have a look at the 
naming conventions in the ITSO environment for our Windows NT server station 
SRVWNT. Therefore, refer to Figure 81 on page 103 and Figure 82 on page 104. 
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DRDA Protocol Setup Relationships 


Windows/NT Setup 


Node Directory 


SNA Server Setup 
Local Node 


Node name VMNODE 
Protocol APPC 


Destination BOECTVM 
name 


Security type 
DB Directory 
DE Alias N 


IN 


Network ID DEIBMIP1 


IP1P13CP 


Local node name 


Local APPC LU 
Local APPC name 


IP1P13C0 
LOCNT 


Connection to NN 


Symbolic destination 
name 


Target DB name 


DCS Parmeters d 
| 


VTAM Setup 


А ІРІРІЗСР 
DB2 for УМ Setur Independent LU IP1P13C0 


DB2 Server for VM APPL(AVS) IP1AITSO 


Figure 81. Relationship of the Definitions between Windows NT and VM 
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DRDA Protocol Setup Relationships 


Windows/NT Setup 


Node Directory SNA Server Setup 
Local Node 


Node name 


Network ID DEIBMIP1 


Protocol 


Local node name ІРІРІЗСР 


Destination 
name Local APPC LU IP1P13C0 
Security type Local APPC Name LOCNT 


DB Directory Connection to NN 


DB Alias 400023700601 - 


DB name | 
N 
Node | 


Authentication 


Local DB name 


arget DB name 


DCS Parmeters 


IP1P13CP 
Independent LU IP1P13CO 


DB2 Server for VSE APPL(CICS) ЇРТАІМС 
DBNAM 


РМАМ 400023700601 


Figure 82. Relationship of the Definitions between Windows NT апа VSE 
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For the APPC connection we have to define the following in the SNA Server 


Manager: 

1. Mode IBMRDB 

2. Local LU 

3. Remote LU (one for VSE and one for VM) 
4. CPI-C (one for VSE and one for VM) 


To call the definitions you click the server SRVWNT in the right window and open 
the Insert APPC box. 


Configured tree 


APPC Modes 
CFIC Symbolic Names 
Active Users 
Hast Security Domains 


Figure 83. Call of the APPC Connection Definitions 
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m. he 


General 
Mode Name IBMRDB 
Comment APPC mode for DRDA 
Limits 
Parallel Session Limit 20 
Minimum Contention Winner Limit 10 
Partner Min Contention Winner Limit 10 
Automatic Activation Limit 0 


Characteristics 


Pacing Send Count 4 
Pacing Receive Count 4 
Max Send RU Size 1024 
Max Receive RU Size 1024 


— РЕР, 


Figure 84. Definition of the DRDA Mode IBMRDB 


Mode Name is in our case IBMRDB. This mode name has to be defined in the 
VTAM Modetab as the logmode. 


Parallel Session Limit specifies the maximum number of parallel sessions 
allowed for this mode. In our case we have an independent LU and therefore the 
number of parallel sessions has to be greater than 1. We defined а maximum of 
20 sessions. 


Minimum Contention Winner Limit specifies the minimum number of sessions in 
which the local LU must be able to initiate conversations without permission 
from the partner LU. 


Partner Min Contention Winner Limit specifies the minimum number of sessions 
in which the partner LU must be able to initiate conversations without 
permission from the local LU. 


Automatic Activation Limit specifies the number of contention winner sessions to 
be activated for the local LU, whenever the connection for this mode is started. 


The contents of the Pacing send/receive counts and the RU (request header unit) 
size depends on the VTAM definitions. In our case we defined а Pacing count of 
4 and а Send/Receive RU size of 1024. 


The next definitions are for the local and remote APPC LUs. You need one local 
APPC LU definition and, for each DRDA connection, you need your own remote 
APPC LU definition. 


LU Alias LOCNT 

Network Name DEIBMIP1 

LU Name IP1P13C0 

Comment Local LU for DRDA 


Figure 85. Local APPC LU Properties 


LU Alias is а name that identifies the local APPC LU. The alias must be unique 
on the server. 
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Network Name is the name that identifies the network. The network name for an 
АРРС LU that communicates with a host should match the NETID parameter іп 
the VTAM start command for the VTAM system. 


LU Name is the name that identifies the local APPC LU. In our case it has to be 
the name of the independent LU of the VTAM. For a local APPC LU the fully 
qualified LU name (network name plus LU name) has to be unique to the server. 


(s TA 

General 

Connection IP1 

LU Alias VMDB2 / VSEDB2 

Network Name DEIBMIP1 

LU Name IP1AITSO / ІРІАМС 

Uninterpreted Name IP1AITSO / ІРІАМС 

Comment APPC Connection to VM / VSE 
Options 

Supports Parallel Sessions 

Implicit Incoming Mode IBMRDB 

No session level security 


Figure 86. Remote APPC LU Properties 


LU Alias is a name that identifies the remote APPC LU. The alias must be unique 
on the server. 


Network Name is the name that identifies the network. The network name for an 
APPC LU that communicates with a host should match the NETID parameter in 
the VTAM start command for the VTAM system. 


LU Name is the name that identifies the remote APPC LU. In our case it has to 
be the name of the LU of the service applications. For VSE it is the CICS 
application name. For VM it is the application name of the AVS machine. These 
applications, of course, have to be defined to VTAM. 


Uninterpreted Name is generally the host application name. Therefore, the 
name is the same as the remote LU name (CICS APPLID for VSE and AVS 
APPLID for VM). 


Options you have to define the support of parallel sessions. The incoming mode 
has to be set to IBMRDB which is defined in the logmode table of VTAM on the 
host and in Figure 84 on page 106 for the Windows NT workstation. 
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General 
Name BOECTVM / BOECTVSE 
Comment CPI-C for VM/VSE 
Conversation Security None 
Mode Name IBMRDB 


Partner Information 
Application TP SRVVMOL / BOEL 
Partner LU Name Alias VMDB2 / VSEDB2 


Figure 87. CPI-C Name Properties for VM and VSE 


Name is the symbolic destination name for a CPI-C conversion. This name has to 
match the name in the node directory of the DB2, refer to Figure 90 on 
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page 111. In our installation we use BOECTVM for DRDA to VM and BOECTVSE 
for DRDA to VSE. 


Conversation security requires а match between the user ID/password of the 
invoking TP and the user ID/password of the system where the remote TP 
resides. The three parameters which are allowed are: 


* None to turn off the conversation security (recommended). 


* Same to require the same user ID/password as that of the remote partner 
LU. 


* Program to specify the user ID/password explicitly. 


Application TP is the application program that uses APPC to accomplish tasks 
for end users and exchange data with other transaction programs (TPs) in an 
SNA environment. In Figure 81 on page 103 you see the relationship between 
the TP (SRVVSEO1 for VM), the CPI-C and the database definitions for VM. For 
VSE, this is shown in Figure 82 on page 104. There the TP name is BOE1. This is 
also the CICS transaction name for DRDA. 


Partner LU Name Alias is the name, which must match the alias name of the 
remote APPC 1495. 


After the definition of the CPI-C, you have finished the SNA Server setup. A 
summary of the definitions is shown in Figure 88 on page 109. 
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STYGT Manager - [ITSOBB] 
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SMÅ Servers 

BA SRVWMT [Active] 
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Local APPC LUz 
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= € SEVWMNT* dbadmini 
ы L5 SRYWNTA dbadmin3 
APPC Mades 
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Figure 88. SNA Server Definition Summary 


After we have finished the SNA Server definitions, we are ready to define the 
database definitions for connections to other systems independent of the 
connection protocol. To VM and VSE we use APPC and to OS/2, AIX and 
Windows NT we use TCP/IP. The definitions for all kinds of database 
connections are described in the following chapter. 


4.3.2.5 DRDA Function of Windows NT 
For DRDA functionality you have to define different entries in the following DB2 
directories: 


* node directory (see Figure 90 on page 111) 

* database directory (see Figure 91 on page 112) 

* dcs database directory (see Figure 92 on page 113) 
Also you have to update the DB2COMM environment variable to support the 
APPC protocol for DRDA. All environment variables that are intended for DB2 
services must be defined as System Environment Variables. When adding or 


updating these variables, your system must be rebooted before new values are 
visible to DB2 services. 


To set system environment variables on Windows NT, do the following: 
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- My Computer 
- Control Panel 
- System 
- Environment 


DB2COMM TCPIP,APPC 
DB2INSTANCE ПВ2 

DB2PATH C:\SQLLIB 

HELP C:\SQLLIB\HELP 
Include C:\SQLLIB\ INCLUDE 


Lib C:\SQLLIB\LIB 


Figure 89. Call of the System Environment Variables 


There you have to change the DB2COMM variable to "APPC,TCPIP" to support 
both protocols. 


For DRDA you have to issue the following DB2 commands at the DB2 command 
processor to connect to VM and VSE: 


”CATALOG APPC NODE VMNODE REMOTE BOECTVM SECURITY PROGRAM” 
”CATALOG APPC NODE VSENODE REMOTE BOECTVSE SECURITY PROGRAM” 


If you want to see all the defined nodes, you can list them with the list node 
directory command. 
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db2 => list node directory 


Node Directory 


Node 1 entry: 


Node name 
Comment 
Protocol 
Hostname 
Service name 


Node 2 entry: 


Node name 
Comment 
Protocol 
Hostname 
Service name 


Node 3 entry: 


Node name 

Comment 

Protocol 

Symbolic destination name 
Security type 


Node 4 entry: 


Node name 

Comment 

Protocol 

Symbolic destination name 
Security type 


db2 => 


Number of entries in the directory = 4 


= OSNODE 
= TCPIP 


= itsops3 
= db2instlc 


= AIXNODE 
= TCPIP 


= 11501 
= db2instlc 


= VMNODE 
= APPC 


= ВОЕСТҮМ 
= PROGRAM 


= VSENODE 


= APPC 


BOECTVSE 


= PROGRAM 


Figure 90. Node Directory of DB2 for Windows NT 


On the next two pages you see the required database and dcs entries. Also the 
directory lists of the database directories after cataloging the VM and VSE DB2 


required entries are shown. 
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"CATALOG DATABASE SRVVMOL AS VMDB2 AT NODE VMNODE AUTHENTICATION DCS” 
"CATALOG DATABASE SRVVSEO1 AS VSEDB2 AT NODE VSENODE AUTHENTICATION DCS" 


- 


db2 => list database directory 


System Database Directory 


Database 1 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 2 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 3 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 4 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 5 entry: 


Database alias 

Database name 

Local database directory 
Database release level 
Comment 

Directory entry type 
Authentication 


db2 => 


Number of entries in the directory = 5 


OSAMPLE 
SAMPLE 
OSNODE 


= 6.00 


0$/2 Sample DB 
Remote 
Server 


VMDB2 
SRVVMO1 
VMNODE 


= 6.00 


VM/DB2 Sample DB 
Remote 
DCS 


VSEDB2 
SRVVSEO1 
VSENODE 


= 6.00 


VSE/DB2 Sample DB 
Remote 
DCS 


ASAMPLE 
SAMPLE 
AIXNODE 


= 6.00 


AIX DB2/6000 Sample DB 
Remote 
Server 


SAMPLE 
SAMPLE 
C:\DB2 


= 6.00 


W/NT DB2 Sample DB 
Indirect 
Server 


Figure 91. Database Directory of DB2 for Windows NT 
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CATALOG DCS DATABASE VMDB2 AS SRVVMO1 PARMS ”SRVVMO1” 
CATALOG DCS DATABASE VSEDB2 AS SRVVSEO1 PARMS ”BOE1” 


( ^ 


db2 -» list dcs directory 
Database Connection Services (DCS) Directory 


Number of entries in the directory = 2 


DCS 1 entry: 

Local database name - VMDB2 
Target database name = SRVVMO1 
Application requestor name = 

DCS parameters = SRVVMO1 
Comment = DCS VM DB/2 
DCS directory release level = 0x0100 

DCS 2 entry: 

Local database name = VSEDB2 
Target database name = SRVVSEO1 
Application requestor name = 

DCS parameters = BOEL 
Comment = DCS VSE DB/2 
DCS directory release level = 0x0100 


db2 => 


Figure 92. DCS Directory of DB2 for Windows NT 


As you have defined these entries in your DB2 for Windows NT, you are ready to 
connect to each DB2 database independent of the platform. The only 
prerequisites are that the DB2 of the partner is running, the connection is up and 
the user is defined on each DB2 to which you want to connect. 


4.3.3 Database Connection from Windows/NT to Other Platforms 


The protocol to get a database connection between DB2 Windows NT and DB2 
VM or DB2 VSE is the SNA-based DRDA. 


a I 


db2 => connect to vmdb2 user clboewnl using xmas25mm 


Database Connection Information 


SQL/DS VM 4.1.0 
CLBOEWN1 
VMDB2 


Database product 
SQL authorization ID 
Local database alias 


db2 => connect to vsedb2 user clboewnl using xmas25mm 


Database Connection Information 


SQL/DS VSE 4.1.0 
CLBOEWN1 
VSEDB2 


Database product 
SQL authorization ID 
Local database alias 


db2 => 


Figure 93. DB2 Windows/NT Connection to VM and VSE via DRDA 
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The protocol to get а database connection between DB2 Windows NT and 
DB2/6000 or DB2/2 is TCP/IP. 


å = 


db2 => connect to osample user clboewnl using xmas25mm 


Database Connection Information 


Database product = DB2/2 3.1.0 
SQL authorization ID = CLBOEWN1 
Local database alias = OSAMPLE 


db2 => connect to asample user clboewnl using xmas25mm 


Database Connection Information 


DB2/6000 2.1.1 
CLBOEWN1 
ASAMPLE 


Database product 
SQL authorization ID 
Local database alias 


db2 => 


Figure 94. DB2 Windows/NT Connection to OS/2 and AIX via TCP/IP 


Another possibility to connect to VM or VSE is to connect indirectly via OS/2. You 
establish a connection via TCP/IP to OS/2 and from there you go via DRDA to 
VM or VSE. The database definitions for this are shown in B.6, “Windows NT 
Definitions” on page 244. 
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db2 => connect to vmsampl user clboewnl using xmas25mm 


Database Connection Information 


SQL/DS VM 4.1.0 
CLBOEWN1 
VMSAMPL 


Database product 
SQL authorization ID 
Local database alias 


db2 => connect to vsesampl user clboewnl using xmas25mm 


Database Connection Information 


SQL/DS VSE 4.1.0 
CLBOEWN1 
VSESAMPL 


Database product 
SQL authorization ID 
Local database alias 


db2 => 


Figure 95. DB2 Windows NT Connection to VM and VSE via OS/2 
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Chapter 5. DRDA2 Client/Server Implementation, Usage and 
Solutions 


5.1 DRDA2 


5.1.1 Introduction 
А distributed relational database might be seen as а group of relational 
databases at multiple locations in а network that users see as а single, coherent 
relational database at their location. 


Figure 96. Real World Distributed Relational Database Connectivity 


Figure 96 shows а relational database system that has data distributed across 
the world. Relational data can exist in one location or, more usually, many 
places in the network. 


5.1.2 Types of Access to Distributed Data 
The Remote Unit of Work, implemented in SQL/DS V3.3, lets a user or 
application program read or update at one remote location per unit of work. With 
remote unit of work, you can have many SQL statements within a unit of work, 
you can access one database management system with each SQL statement, 
and you can access one database management system within a unit of work. 
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Consider а banking example. Using remote unit of work, you can transfer funds 
from а savings account table to а checking account table, if both tables are at 
the same remote location. 


Figure 97 shows how the application first requests an update to the savings 
account table (1) and then requests an update to the checking account table (2). 


Savings/Checklng System 
<q— 1. Subtract from ———» 


Savings 


sj — 2. Addto > 
Checking 


4—3. Commit or ——— 
Rollback 


Ty 


Figure 97. Remote Unit of Work 


Distributed Unit of Work lets a user or application program read or update data 
at multiple locations within a single unit of work. With distributed unit of work, 
you can have many SQL statements within a unit of work, you can access one 
database management system with each SQL statement, and you can access 
many database management systems within a unit of work. 


Using the same banking example, now imagine that the savings account table 
and the checking account table are on two different computer systems. 


As shown in Figure 98 on page 117, distributed unit of work processing permits 
an application to debit the savings account (1), credit the checking account (2), 
and either commit or roll back the operations in both computer systems (3), 
treating all of the changes as a single transaction, or unit of work. 
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Saving System 


RDBMS 
s—— 1. Subtract from ————————— A» 


Savings 


-8—— — 2. Add to 


7 Checking 


Checking System 
3. Commit or 


Rollback 
RDBMS 


Figure 98. Distributed Unit of Work 


Commit and rollback are coordinated at all locations so that if a failure occurs 
anywhere in the system, data integrity is preserved. If there was a failure in the 
middle of the banking transaction just described, and commit or rollback was not 
coordinated, the savings account could be debited money and the checking 
account might not be credited the money. This costly error is avoided by the 
coordination of commit and rollback, or two-phase commit processing. 


5.1.3 Two-Phase Commit 


The distributed unit of work is a coordinated approach involving two phases. A 
sync point manager (SPM) maintains consistency in changes made to protected 
resources. The primary functions of a sync point manager include, but are not 
limited to, the following: 


1. Keeping track of and logging LUW state information. 


2. Keeping track of and logging all local protected resource manager (PRM) 
names that are involved with a logical unit of work. 


(4%) 


. Coordinating the СОММІТ and ROLLBACK of all local PRMs. 


5 


Initiating resynchronization protocols for any logical unit of work that may be 
in the in-doubt state because of a system or communication failure. 


A sync point manager is required wherever resources may be updated. This 
requires that sync point managers at each distributed location communicate with 
one another using architected protocols. 


Note: In conjunction with the two-phase-commit processing we are using a new 
term Heuristic which means 'giving a direction'. A direction is given manually 
and then the action is performed. Heuristic damage means that an incorrect 
direction was given and therefore, some wrong actions have been performed 
automatically. 


For example a heuristic commit or rollback of an in-doubt transaction is one that 


was initiated manually by an operator instead of being driven by the transaction 
manager. 
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5.1.4 Resynchronization 
Resynchronization occurs if two-phase commit processing is interrupted by а 
resource failure. А resource failure may be caused by а node failure, а session 
failure, а program failure or other problems. 


The steps involved in resync include those outlined below. Note that they only 
talk about LUs. For DB2 for VSE the LU is CICS/VSE. For DB2 for VM the LU is 
AVS. 


The Resynchronization Steps 


1. Restoring the data structure representing the status of the sync point 
operation, if the LU failed. When an LU is restarted the SPM retrieves log 
records from а log in order to restore data structure representing protected 
resources that were active at the time of the failure. The local-protected 
resource managers may also retrieve log records related to each local 
resource. From log records, the SPM can determine the resources for which 
it is responsible for initiating resync. 


2. Starting a program in the LU that is responsible for initiating resync. For LU 
6.2 resources, this TP is a services transaction program that carries out the 
remaining steps. 


3. Establishing a SYNC. LEVEL conversation with the resync TP in the other LU 
involved in the resync. 


4. Exchanging log names to verify that the partner has the appropriate memory 
of the LUW. 


5. Comparing and adjusting states of the LUW at both partners. 
Resync when Partner is not Active 


After an LU failure, it is possible that the partner responsible for resync is unable 
to establish the resync conversation because the LU has not been restarted. The 
responsible LU retries the resync at implementation defined intervals until it 
receives the signal that the failed LU is active. It can then start the resync 
process. 


Resynchronization during Startup 


On VM, the last step in the startup procedure is resynchronization initialization. 
This step is initiated by DB2 for VM for the following reasons: 


* To ensure that the VM sync point manager (VM/CRR) logs and DB2 logs are 
synchronized 
e To inform VM/CRR that DB2 is ready to accept resynchronization activity 
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RIO717I Start SQLSTART EXEC: 03/28/97 09:36:21 CET. 
RI0663I FILEDEFS in effect are: 
RISQLLD DISK ARISQLLD LOADLIB 01 
DISK DISK 200 
OGDSK1 DISK 201 
DSK1 DISK 202 
RIUSRDD DISK USERLIB LOADLIB * 
RIARCH TAP1 SL 00001 
RITRAC ТАР2 SL 00001 
RILARC ТАРЗ SL 00001 
RISSCR DISK ARISSCR MACRO 
RISSTR DISK ARISSTR MACRO 
RISCCS DISK ARISCCS MACRO 
ETID DISK SNA NETID 
RISPOOL DISK SRVVMO1 ARISPOOL * 
RIO0201 Virtual machine addressing mode = 31 
Virtual machine storage size = 32768KB 
RI0025I The program ARISQLDS is loaded at ADCF10. 
RI0025I The program ARIXRDS is loaded at 86A4C0. 
RI00251 The program ARIXSXR is loaded at EA6170. 
RI00251 The program ARICMOD is loaded at EAB240. 
RI0015I NETID parameter value is DEIBMIP1. 
5I PROTOCOL parameter value is AUTO. 
5I SYNCPNT parameter value is Y. 
RI0015I ACCOUNT parameter value is М. 
5I DUMPTYPE parameter value is F. 
RI0015I LOGMODE parameter value is Y. 
RI0015I STARTUP parameter value is W. 
RI0015I SYSMODE parameter value is M. 
RI0015I EXTEND parameter value is М. 
RI0015I DBNAME parameter value is SRVVMOL. 
RI0015I RESID parameter value is SRVVMOL. 
RI0015I TRACDBSS parameter value is 00000000000. 
RI0015I TRACDRRM parameter value is 0000. 
RI0015I TRACDSC parameter value is 00. 
RI0015I TRACRDS parameter value is 0000000. 
RI0015I TRACWUM parameter value is 0. 
RI0015I TRACCONV parameter value is 0. 
RI0015I TRACSTG parameter value is 0. 
RIO0161 TRACEBUF parameter value is 0. 
RI0016I CHKINTVL parameter value is 10. 
RIO0161 NCSCANS parameter value is 30. 
RIO0161 NCUSERS parameter value is 5. 
RIO0161 NDIRBUF parameter value is 30. 
RIO0161 NLRBS parameter value is 2520. 
RIO0161 NLRBU parameter value is 1000. 
RIO0161 NPACKAGE parameter value is 10. 
RIO0161 NPACKPCT parameter value is 30. 
RIO0161 NPAGBUF parameter value is 30. 
RIO0161 SLOGCUSH parameter value is 90. 
RIO0161 SOSLEVEL parameter value is 10. 
RIO0161 DISPBIAS parameter value is 7. 
RIO0161 LTIMEOUT parameter value is 0. 
RI0283I Log analysis is complete. 
RIO2821 LUW UNDO is completed. 
RIO2811 LUW REDO is completed. 
RI0143I The application server has been initialized 
with the following values: 
CHARNAME = INTERNATIONAL, DBCS - NO, CHARSUB - SBCS, 
CCSIDSBCS - 500, CCSIDMIXED = 0, CCSIDGRAPHIC - 0. 
ARIO134I Application server SRVVMO1 has been 
identified as a global resource. 
ARI0060I SQL/DS initialization complete. 
RI0045I Ready for operator communications. 
АВ101741 Resynchronization initialization has started. 
Date: 1997-03-28 Time: 09:36:31 
ARIO175I Resynchronization initialization has completed. 
Date: 1997-03-28 Time: 09:36:31 


* 
* 
* 
* 


> > => Р > > > > рь ог 0 Р Р Р 
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Figure 99. Startup of DB2 
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5.1.5 Enhancements Common to VSE & VM 


120 


5.1.5.1 Log Changes 
Log changes need to be made to support two-phase commit. The log changes 
are not visible to the user. 


5.1.5.2 Initialization Parameter: Sync Point Manager (SPM) 
This initialization parameter specifies whether or not а sync point manager 
(SPM) will be used to coordinate DRDA 2 DUOW two-phase commit and 
resynchronization activity. 


The default is SYNCPNT - Y. 


IF Y is specified, the server will use а sync point manager if possible to 
coordinate two-phase commits and resynchronization activity. If N is specified, 
the server will not use an SPM to perform two-phase commits. If Y is specified 
but DB2 for VSE & VM finds that a sync point manager is not available, then the 
server will operate as if N were specified. 


5.1.5.3 Database Lock Wait Timeout/Deadlock 

Prior to DB2 for VSE & VM Version 5 Release 1, once a user goes into lock wait, 
he remains in lock wait until he can be granted the lock or is rolled back due to 
a deadlock. In this release, a new initialization parameter, LTIMEOUT, can be 
specified on DB2 for VSE & VM. 


The LTIMEOUT parameter specifies how many seconds before a lock wait will 
time out. The range of the LTIMEOUT value is 0 to 99999 seconds. 


The default is LTIMEOUT = 0. 


This parameter allows the user to specify what lock timeout period, if any, 
should be used for all agents connected to this database. The current transaction 
is rolled back when the lock timeout period has expired. The agent will notify the 
application that a lock timeout has occurred with SQLCODE -911 (SQLSTATE 
40001). A reason code will be returned to indicate whether it is a deadlock or 
lock timeout situation (reason code 2 for a deadlock, reason code 68 for a lock 
timeout). 


The user should consider adjusting the lock timeout control parameter in those 
environments where lock contention between applications has begun to affect 
the desired performance and concurrency levels. If the user has determined that 
a lock timeout is required for their environment, we recommend a starting value 
equivalent to the maximum period of time that the user wishes any applications 
to wait for a lock. 


With the following screens, you can check the LTIMEOUT parameter. 
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- 


show initparm 


АК100651 


Мыз 


Initialization parameters at 1997-03-28 09:36:42 


AMODE 31 DUALLOG N NETID DEIBMIP1 
PROTOCOL AUTO SYNCPNT Y ACCOUNT N 

DBMODE G DUMPTYPE F LOGMODE Y 
STARTUP W SYSMODE M EXTEND N 
CHARNAME INTERNATIONAL DBNAME SRVVMO1 

RESID SRVVMOL PARMID TRACDBSS 00000000000 
TRACDRRM 0000 TRACDSC 00 TRACRDS 0000000 
TRACWUM 0 TRACCONV 0 TRACSTG 0 
TRACEBUF 0 ARCHPCT 80 CHKINTVL 10 
NCSCANS 30 NCUSERS 5 NDIRBUF 30 

NLRBS 2520 NLRBU 1000 NPACKAGE 10 
NPACKPCT 30 NPAGBUF 30 SLOGCUSH 90 
SOSLEVEL 10 DISPBIAS 7 LTIMEOUT 0 


SQL/DS operator command processing is complete. 


Figure 100. Initialization Parameters 


Мы: 


(7. I 
counter * 
Counter values at DATE="03-28-97"  TIME="08:21:53" 
Calls to RDS RDSCALL : 15634 
Calls to DBSS DBSSCALL: 31260 
LUWs started BEGINLUN: 144 
LUWs rolled back ROLLBACK: 19 
System checkpoints taken CHKPOINT: 11 
Maximum locks exceeded LOCKLMT : 0 
Lock escalations ESCALATE: 0 
Waits for lock WAITLOCK: 4 
Deadlocks detected DEADLCK : 0 
Looks in page buffer LPAGBUFF: 43900 
DBSPACE page reads PAGEREAD: 2640 
DBSPACE page writes PAGWRITE: 773 
Looks in directory buffer LDIRBUFF: 5069 
Directory block reads DIRREAD : 317 
Directory block writes DIRWRITE: 1065 
Log page reads LOGREAD : 4 
Log page writes LOGWRITE: 198 
Total DASD reads DASDREAD: 2961 
Total DASD writes DASDWRIT: 2036 
Total DASD I/0 DASDIO 4997 
Lock timeouts detected LTIMEOUT: 0 
ARIOO65I SQL/DS operator command processing is complete. 


Figure 101. Counter Information 


The new counter «Lock timeouts detected LTIMEOUT: 0» is added in the 
counter display. This counter shows how many times the LTIMEOUT parameter 
is reached when the database is running. 
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5.1.5.4 SHOW CONNECT Changes 
The SHOW CONNECT command has some more information about the user 
agent. The significant change is the protocol information. 


E. I 


show connect 
Status of Connected SQL/DS Users 1997-03-28 09:14:35 
Checkpoint agent is not active. 
User ID: СІВОЕҮМІ SQL ID: CLBOEVMI 
User is inactive. 
State started: 1997-03-28 08:31:14 
Conversation started: 1997-03-28 08:30:50 
LUWID: DEIBMIP1.IP1P10CP.AE6CECCEB230.0001 
EXTNAM: DB2BP.EXE 00610001 
Requester: DDCS/2 V2.1.1 at STATIONI 
Protocol: DRDA 
User ID: СІВОЕҮМІ SQL ID: CLBOEVMI 
User is inactive. 
State started: 1997-03-28 08:47:43 
Conversation started: 1997-03-28 08:37:02 
CPU time: 00:00:02 
LUWID: DEIBMIPI.IPIPIICP.AEGCEE2DBBE9.0001 
EXTNAM: DB2BP.EXE 00880001 
Requester: DDCS/2 V3.1.0 at STATION2 
Protocol: DRDA 2 Phase Commit 
SQL/DS users are active. 
SQL/DS users are waiting. 
SQL/DS users are inactive. 
5 501/05 agents are available. 
144 SQL/DS user connections are available. 
ARIOO65I SQL/DS operator command processing is complete. 


NOO 


Figure 102. Connect Information 


The SHOW CONNECT command also can be called from an application program. 
The example above shows that DRDA2 protocol is being used. There is а sync 
point manager involved. This means that the LUW is capable of multiple-site 
update activity. 


5.1.5.5 New Command SHOW INDOUBT 

DB2 for VSE & VM is required to record the heuristic decisions on the in-doubt 
LUWs. Each record contains information about the operator action (that is, 
FORCE) on behalf of an in-doubt LUW. 


SHOW INDOUBT will display TRANID, USERID, LUWID, EXTNAM, REQUESTER, 
PACKAGE, STATE, DAMAGE, Prepared-TO-Commit state started and the 
Heuristic state started timestamp for all in-doubt LUWs involved іп two-phase 
commits. In VSE, the RECTOK (CICS recovery token) is also displayed. 


SHOW INDOUBT will display one of the three messages following the user ID for 
each in-doubt LUW: 


* IS PREPARED FOR COMMIT OR ROLLBACK for an LUW which completed the 
first phase of the two-phase commit. 


e COMMITTED-H for an LUW which completed the first phase of the two-phase 
commit and then a heuristic action was performed to commit the updates. 


* ROLLBACK-H for an LUW which completed the first phase of the two-phase 
commit and then a heuristic action was performed to rollback the updates. 
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»»—SHOW INDOUBT >< 


5.1.5.6 New Command RESET INDOUBT 

Records of in-doubt LUWs which have been forced by heuristic actions can be 
erased using the RESET INDOUBT command. This should not be done until after 
they have been reconciled with directions from the recovery server. The operator 
can specify one or more TRANIDs for the in-doubt LUWs which have been forced. 
The value of the TRANIDs are obtained by issuing the SHOW INDOUBT 
command. 


Er 
pp—RESET INDOUBT—( tranid——) >< 


Figure 103. Syntax of the SHOW INDOUBT Command 


A heuristic commit or rollback of an in-doubt transaction is one that was initiated 
manually by an operator instead of being driven by the transaction manager. The 
only way heuristic damage can be corrected is to restore the database from an 
archive to manually correct the data based on knowledge of the application. This 
damage correction must be coordinated with all of the participating application 
servers to ensure that the data is consistent in each individual application server 
and that it is consistent between all of the participating application servers. 


5.1.6 VSE Specification 


This function describes the VSE specific changes necessary to implement the 
application server support for Distributed Relational Database Architecture 
(DRDA) Level 2 (Distributed Two-Phase Commit) in VSE. 
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DB2 for VSE DUOW Environment 


Figure 104. Distributed Unit of Work for DB2 VSE 
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This figure shows how а workstation application might use DDCS for OS/2 to 
execute a distributed unit of work between two DB2 for VSE servers on different 
VSE/ESA systems. Notice that DDCS registers itself with its own sync point 
manager. DDCS then establishes protected conversations with CICS AXE 
transactions. Each AXE transaction registers itself with a locally installed 
CICS/VSE sync point manager and CICS will perform any sync point logging and 
resynchronization activity. The AXE transactions use the VSE ХРСС protocol to 
communicate with the DB2 for VSE servers. 


A separate task-related user exit program will be enabled and started for each 
DB2 for VSE application server to interface with the CICS/VSE sync point 
manager in support of distributed unit of work (two-phase commit). The entry 
name of the task-related user exit program is ARIOxAXE, where x can be 0-9 or 
A-Z, and is the last character of a DB2 for VSE application server APPLID. 


To start and enable ARIOOAXE, the AXE transaction issues the command: 


Ес CICS ENABLE PROGRAM(ARICDRDA) ENTRYNAME (ARIOOAXE) | 


Figure 105. AXE Command 


The AXE transaction displays the following messages at the operator console 
when it has successfully enabled and started the task-related user exit program 
(ARIOOAXE). 
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ARIO187I ARIOOAXE is enabled for DRDA support 


ARIO1881 ARIOOAXE has an entry point. 


Figure 106. AXE Messages 


Two new transactions will be provided, DAXP and DAXT. The DAXP transaction 
sets parameters that will be used by the AXE transaction when it autostarts the 
DRDA TRUE support (SYNCPNT = Y). The DAXT transaction provides functions 
similar to what CIRB/CIRT provide in the local Online Resource Adapter 
environment. 


The DAXP transaction has three parameters. 


»»—DAXP—1 Г] I —.—server-name >< 


password _langid 


Figure 107. Syntax of the DAXP Command 
PASSWORD (positional) This password establishes the operator’s authority to 
terminate DRDA support within CICS on behalf of a DB2 for VSE application 


server. 


LANGID (positional) This parameter defines the language the DB2 for VSE server 
uses to display error and information messages. 


SERVER-NAME (positional) This parameter is required and specifies the 
application server for which Distributed Unit of Work support is to be enabled. 


The DAXT transaction has four parameters. 


»»--АХТ-- p Г, —,—server-name—a 


password L-mode— L-interval 


Figure 108. Syntax of the DAXT Command 


PASSWORD (positional) This password establishes the operator's authority to 
terminate DRDA support within CICS on behalf of a DB2 for VSE application 
server. 


MODE (positional) is the second positional parameter. The default is NORMAL. 
The other option is QUICK. This establishes the shutdown mode. If NORMAL, 
the DAXT transaction will not disable the DRDA TRUE if an AXE transaction 
which has accessed the DRDA TRUE is still active. It will wait for the interval 
time to expire and try again. If QUICK, the DAXT transaction will disable the 
DRDA TRUE immediately, unless an SQL COMMIT or ROLLBACK is ongoing. 


INTERVAL (positional) The number of seconds that the DAXT transaction should 
delay before freeing the terminal. The value you specify for interval represents 
an interval of time measured in seconds. If the DAXT transaction does not finish 
immediately, it waits the amount of time you specify. 
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SERVER-NAME (positional) This parameter is required and specifies the 
application server for which Distributed Unit of Work support is to be enabled. 


5.1.6.1 CICS Restart Resynchronization Support 

If the CICS Restart Resynchronization Support was not enabled when the CICS 
system was installed, updates to the following CICS tables must be done to 
enable the CICS Restart Resynchronization capability. 

DFHJCT Journal Control Table 


A journal used for the CICS system log must be defined in the DFHJCT by 
specifying JFILEID=SYSTEM in a DFHJCT TYPE=ENTRY macro. 


DFHPCT Program Control Table 


To generate the DFHPCT entry to use the CICS Restart Resynchronization 
capability. 


Enter: DFHPCT TYPE=GROUP,FN=RMI 
DFHPPT Processing Program Table 


To generate the DFHPPT entry to use the CICS Restart Resynchronization 
capability. 


Enter: DFHPPT TYPE=GROUP,FN=RMI 
DFHSIT . System Initialization Table 


The DFHSIT macro must include the JCT parameter. 


5.1.6.2 Operator Commands for In-doubt LUWs 
SHOW ACTIVE Displays the status of active agent structures. 


SHOW CONNECT Displays the status of all users connected to the application 
server. 


FORCE COMMIT Heuristically forces an in-doubt LUW to COMMIT. 
FORCE ROLLBACK Heuristically forces an LUW to ROLLBACK. 
SHOW INDOUBT Displays the status of all DRDA2 distributed units of work. 


RESET INDOUBT Causes а heuristically committed or rolled back unit of work to 
be forgotten by the database. 


5.1.6.3 New Phases 
* ARICDAXD for the DAXP and DAXT transactions 


* ARICDRAD for the DRDA task-related user exit 
* ARICDR2 for the DR2DFLT control block 
* ARICDEBD for the DRDA TRUE enable 
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5.1.7 VM Specification 
As previously mentioned, DB2 for VSE & VM requires the use of а sync point 
manager to coordinate two-phase commit. In the VM environment, DB2 for VM 
will use VMCRR as its sync point manager. 


DB2 for VM DUOW Environment 


| DB2 for 
M 2 


Figure 109. Distributed Unit of Work for DB2 VM 


This figure shows how a workstation application might use DDCS for OS/2 to 
execute a distributed unit of work between two DB2 for VM servers on different 
VM/ESA systems. Notice that DDCS registers itself with its own sync point 
manager. DDCS then establishes protected conversations with DB2 for VM 
server1 and 2. Each DB2 for VM server uses the CRR Recovery Server installed 
in its VM system to perform any sync point logging and resynchronization 
activity. Notice also that each DB2 for VM server registers itself with the CRR 
Recovery Server on its system. 


DB2 for VM servers will enable distributed unit of work support when the 
parameters PROTOCOL-AUTO and SYNCPNT=Y are specified at startup. 


5.1.7.1 Operator Commands for In-doubt LUWs 
SHOW ACTIVE Displays the status of active agent structures. 


SHOW CONNECT Displays the status of all users connected to the application 
server. 


FORCE COMMIT Heuristically forces an in-doubt LUW to COMMIT. 
FORCE ROLLBACK Heuristically forces an LUW to ROLLBACK. 


SHOW INDOUBT Displays the status of all DRDA2 distributed units of work. 
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RESET INDOUBT Causes а heuristically committed or rolled back unit of work to 
be forgotten by the database. 


5.1.7.2 Resynchronization Initialization 

To notify the CRR recovery server of its readiness to accept resynchronization 
communications, a DB2 for VM server performs Resynchronization Initialization 
with the CRR recovery server when it starts up in multiple user mode. This 
involves sending an Exchange Log Names request to the CRR recovery server 
before the first sync point is processed. The CRR recovery server sends an 
Exchange Log Names reply. Then DB2 for VM and the recovery server save each 
other’s log name, LU name and TPN to use in later validations. 


The details of what the database manager does during resynchronization 
initialization follow: 


ARIO1741 Resynchronization initialization has started. 
Date: 03/28/97 Time: 17:03:43 


* The database manager installs sync point manager routine exits into 
storage. 


* The database manager saves the CRR recovery server's current log name 
and TPN. This information is later used. 


* A conversation with the CRR recover server is allocated using a 
synchronization level of CONFIRM. 


* The database manager receives an Exchange log Names reply from the CRR 
recovery server. 


P I 


ARIO181I Тһе CRR recovery server is resynchronizing work 
with the database manager. 


Date : 03/28/1997 Time : 17:03:43 
ARIO182I Transaction ID: 12 


LUWID: DEIBMIP1.IP1P11CP.AE6CEE2DBBE9.0001 


V Еж 


5.1.7.3 Resynchronization Recovery 

Resynchronization occurs if two-phase commit processing is interrupted by а 
resource failure. The CRR recovery server initiates the resynchronization 
recovery function to ensure consistent completion of the sync point by all 
registered resources for which data was logged. Using information stored in its 
log, the CRR recovery server determines which resources managers (that is, 
DB2 for VM) should be included in the recovery and allocates APPC 
conversations with them. 


To allocate an APPC conversation with DB2 for VM, the CRR recovery server 
uses information that DB2 for VM provided when it registered with the SPM 
(using the CSL routine DMSREG). 


The resynchronization recovery transaction between the CRR recovery server 
and the database manager consists of two functions: 


* Exchanging log names 


128  DB2 Server VM and VSE V5R1 


The CRR recovery server initiates this exchange with DB2 for VM to ensure 
that the data they saved from resynchronization initialization is still valid. 
* Comparing states 


The CRR recovery server initiates this exchange with DB2 for VM to compare 
the state of the CRR logical unit of work with the state of the database 
manager's logical unit of work. 


5.2 DRDA2 Implementation and Customization 


5.2.1 Sync Point Manager on DDCS Gateway 
The LU 6.2 Sync Point Manager is a function that is included in the DDCS 
Multi-User Gateway (DB2 Connect). SPM provides support that enables 
distributed applications to access multiple remote database application servers 
using DRDA2 protocols. You need to install and use SPM if your distributed 
database applications will make use of the DRDA2 Distributed Unit of Work 
(DUOW) known as two-phase commit. 


VM/ESA VSE/ESA 


DB2 Server for 


DB2 Server fo VSE & VM 


VSE & VM 


ТСРЛР 


RO тв NETBIOS 


EN 
DDCS Gateway 
Application Requester ея 


EEE 


Glient 


LAN Server 


Figure 110. ITSO DRDA2 Implementation Setup 
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5.2.2 Participants in Two-Phase Commit Process 


130 


This section describes systems that take part in the SPM scenario. 
Application Requester 


DB2 assumes the syncpoint model defined by DRDA where only the application 
requester can initiate a commit. The role of the coordinator at the application 
requester is as follows: 


1. It registers the DUOW request with a transaction manager. 
2. It delegates further coordination of the DUOW to the transaction manager 
and the SPM. 


Transaction Manager 


Distributed units of work must always be registered with a transaction manager. 
This is done by the coordinator at the application requester. The transaction 
manager is responsible for: 


1. Preserving the integrity of DUOW requests. 


2. Providing logging, registration and decision making services for DUOW 
requests. 


3. Guaranteeing the integrity of the results of the DUOW. 
Sync Point Manager 


The SPM serves as the LU 6.2 coordinator on behalf of application requesters, 
the transaction manager database, and the DRDA2 application servers. The SPM 
is an independent LU and it communicates with downstream DRDA2 databases 
using APPC protocols. However, upstream protocols can use other protocols; for 
example, APPC, IPX, Named Pipes, NETBIOS, or TCP/IP. 
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5.2.3 Two-Phase Commit Scenario 


Server B DRDA-2 Server C 
DB2 Transaction 
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Figure 111. Two-Phase Commit Scenario 


1. The coordinator at system A registers automatically with the transaction 
manager database at system B, using TM_DATABASE=TMB. 


2. The application requester at system A issues a DUOW request to the DRDA2 
server, for example: 


connect to database SRVVMOL 
update database SRVVMO1 
connect to database SRVVSEO1 
update database SRVVSEO1 
commit 


3. When the commit is issued, the coordinator at the application requester 
sends prepare requests to the SPM for the updates requested at the servers 
C and E. 


4. The SPM is running on server C as part of DDCS, and it sends the prepare 
requests to the servers C and E. 


5. Servers C and E in turn acknowledge the prepare requests. 


6. The SPM sends back an acknowledgement to the coordinator at the 
application requester. 
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7. The coordinator at the application requester sends а request to the 
transaction manager at system B for the servers that have acknowledged 
and the transaction manager decides whether to commit or rollback. 


8. The transaction manager logs the commit decision, and the updates are 
guaranteed from this point. 


9. The coordinator issues commit requests, which are processed by the SPM, 
and forwarded to servers C and E, as were the prepare requests. 


10. Servers C and E commit and report success to the SPM. 


5.2.4 DRDA2 Implementation Steps 
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Following are the steps we performed at the ITSO to implement the DRDA2 
connections. 


5.2.4.1 Communication Server Setup 

We used STATION2 as the DDCS gateway. The PU name for this workstation is 
IP1P11. The configuration of the communication server is the same as described 
in 4.2.4, "OS/2 Customization" on page 77 for STATION1, except for the addition 
of two independent LUs. 


1. The two independent LUs, one for DRDA1 and the second for DRDA2, will be 
defined as follows in the .NDF file of your Communication Server for the 
configuration you are using. In our case it was APPN11.NDF. The PU name 
should be the first part of each LU name and alias if you are using APPN for 
dynamic creation of LUs. 


DEFINE LOCAL LU LU NAME(IP1P110A) 
DESCRIPTION(DRDA1) 
LU ALIAS (IP1P110A) 
NAU ADDRESS(INDEPENDENT LU); 


DEFINE LOCAL LU LU NAME(IP1P110B) 
DESCRIPTION(DRDA2) 
LU ALIAS (IP1P110B) 
EXTERNAL PROVIDER(SYNCPT PROVIDER,REMOTE TP PROVIDER) 
NAU ADDRESS(INDEPENDENT LU); 


Note: The Communications Server Setup screens make no provision for 
modifying the "EXTERNAL PROVIDER" parameter. That is why the .NDF file 
was edited. 


2. Make your DRDA1 LU your default. You can do that by using the CS GUI 
interface or by adding a line to the .NDF file as shown in the 
DEFINE DEFAULTS section: 


DEFINE DEFAULT LU ALIAS(IP1P110A) 
Note: If you fail to do this, then DRDA1 calls will fail if DB2 is not started. 


3. Use the CMVERIFY command to verify the new configuration after saving 
your changes. 


5.2.4.2 SPM Installation 

It is assumed that you have already installed DDCS on the workstation. Now you 
can restart the installation program and select Add Additional Components and 
from there select Syncpoint Manager for installation. 
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5.2.4.3 Creating DB2 Instance 
Create the DB2 instance on the same system. You can create а new instance by 
using the following command 


db2icrt <muinstance> 


or you can use the default instance DB2. We have used the default instance in 
our setup. 


5.2.4.4 Create Transaction Manager Database 

Create a TM database. Any DB2 database can be used for this purpose. We 
recommend that the TM database be а local database on the DDCS gateway. 
You can use the following command: 


db2 create database TMB on E: alias TMB 


The name and alias of the TM database should be the same. 


5.2.4.5 Update Database Manager Configuration for TM Database 
If the TM database is а local one update the TM DATABASE database manager 
configuration parameter with the name of the TM database: 


db2 update database manager configuration using tm database TMB 


5.2.4.6 Catalog TM Database 

Leave this step if the TM database is local on the DDCS gateway. If not, catalog 
it on the DDCS gateway and also catalog the node where it resides. In our case 
the TM database ТМВ is а local database but you can use the following 
command to catalog the node and remote TM database: 


db2 catalog tcpip node TMBNODE remote SERVERB server dbinstlc 
db2 catalog database TMB as TMB at node TMBNODE 


You must also perform the following steps on the TM database node, so that it 
can connect to the SPM node. 

db2 catalog tcpip node SPMNODE remote SERVERD server dbinstlc 

db2 catalog database SPMNAME as SPMNAME at node SPMNODE 


The name of the SPM database should be the same as the LU defined earlier 
with the EXTERNAL PROVIDER parameter. In our case it is IP1P110B. 


5.2.4.7 Create SPM Database 

This database is created automatically when you stop and restart DB2 after 
completing all the remaining steps but, if not, you can create it on the DDCS 
gateway using the following command: 


create database IP1P110B on e: alias IP1P110B 


5.2.4.8 Update Database Manager Configuration for SPM NAME 
Update SPM NAME on the DDCS gateway system. The SPM NAME equals the 
LUNAME that was defined with EXTERNAL SUPPORT. 


db2 update database manager configuration using SPM NAME IP1P110B 
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5.2.4.9 DB2COMM Environment Variable 
Ensure that the DB2COMM environment variable includes the value APPC in the 
config.sys file. 


5.2.4.10 DB2 Restart 
Now stop and restart DB2 to make all the changes permanent. DB2 should start 
with all the protocols successfully. 


5.2.4.11 Binding Files 

Before you can start using the DRDA function you need to bind certain files for 
each server platform you are using. For us it was VM and VSE. There are two 
files in the SQLLIN\BND directory with the names DDCSVM.LST and 
DDCSVSE.LST. You will have to use these files to bind and create all the 
required packages. Prior to performing the binds it is recommended that you 
give the following authorities to NULLID: 


grant select on system.syscatalog to nullid with grant option 
grant select on system.syscolumns to nullid with grant option 
grant select on system.sysindexes to nullid with grant option 
grant select on system.systabauth to nullid with grant option 
grant select on system.syskeycols to nullid with grant option 
grant select on system.syssynonyms to nullid with grant option 
grant select on system.syskeys to nullid with grant option 

grant select on system.syscolauth to nullid with grant option 


If the “with grant option’ is not specified then there will be problems later when 
trying to run the packages. This is documented in the DDCS Users Guide in the 
"Binding Applications and Utilities’ section. It is a step that is often overlooked. 


db2 connect to <user> using <password> 

db2 bind E:\sqllib\bnd\@ddcsvm.1st blocking all sqlerror continue 
messages ddcsvm.msg grant public 

connect reset 


db2 connect to <user> using <password> 

db2 bind E:\sqllib\bnd\@ddcsvse.|st blocking all sqlerror continue 
messages ddcsvse.msg grant public 

connect reset 


5.2.5 Sample CLP Script for Testing DRDA2 


We wrote a simple, easy to understand script to show our DRDA2 setup and its 
usage. In our scenario we have two bank branches one having DB2 Server on 
VM and the other DB2 Server for VSE and both are at remote locations. The 
processing clerk has an OS/2 workstation with a DDCS gateway for connection to 
these locations. He receives a cheque which transfers an amount from the VM 
branch to the VSE branch. 


5.2.5.1 Layouts of VSE and VM Tables 
VMCUST 


This table is on VM and has the following layout: 


ACCTNO Char (10) 
NAME Char (25) 
BALANCE Integer 
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VSECUST 


This table is on VSE and has the same layout as the VM table: 


ACCTNO Char (10) 
NAME Char (25) 
BALANCE Integer 


5.2.5.2 Sample Script 


We created a file named drda2.clp and wrote the following commands in it: 


set client connect 2 syncpoint twophase; 

query client; 

connect to SRVVMO1 user «userid» using «password»; 
select * from vmcust where acctno = ”1210003334” 
update vmcust set balance = balance - 5000; 

select * from vmcust; 

connect to SRVVSEO1; 

select * from vsecust; 

update vsecust set balance = balance + 5000 where custno = /2223334445' 
select * from vsecust; 

commit; 

disconnect SRVVMO1; 

disconnect SRVVSEO1; 


We used the following command to execute this script: 
db2 -c- -o- -tfdrda2.clp -zdrda2.out 


Options used: 

-c- autocommit off 

-0- suppress output 

-tf take input from named file using standard SQL terminator ; 
-2 direct output to named file 


You have to restart DB2 with all protocols started automatically with no errors in 


the db2diag.log. Set the DIAGLEVEL to 4. 


5.2.5.3 Output File (DRDA2.OUT) of Script DRDA2.CLP 
pe 

DB20000I The SET CLIENT command completed successfully. 

The current connection settings of the application process are: 


CONNECT 

DISCONNECT 

MAX NETBIOS CONNECTIONS 
SQLRULES 

SYNCPOINT 


2 
EXPLICIT 
1 

DB2 
TWOPHASE 


Database Connection Information 


SQL/DS VM 5.1.0 
CLBOEVM1 
SRVVMO1 


Database product 
SQL authorization ID 
Local database alias 
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cont 
ACCTNO NAME BALANCE 
1210003334 Shahid Naqvi 45000 


1 record(s) selected. 


DB20000I Тһе SQL command completed successfully. 


ACCTNO NAME BALANCE 

1210003334 Shahid Naqvi 40000 
1220003334 Kashif Karim 31000 
1230003334 Amer Mubbasher 8500 


3 record(s) selected. 
Database Connection Information 


Database product SQL/DS VSE 5.1.0 


SQL authorization ID = CLBOEVMI 

Local database alias = 5ВҮУ5Е01 
ACCTNO NAME BALANCE 
2223334445 Adnan Siddiqui 25000 
5556667778 Shuja ur Rehman 50000 


2 record(s) selected. 


DB20000I Тһе SQL command completed successfully. 


ACCTNO NAME BALANCE 
2223334445 Adnan Siddiqui 30000 
5556667778 Shuja ur Rehman 50000 


2 record(s) selected. 
DB20000I Тһе SQL command completed successfully. 


DB20000I Тһе SQL DISCONNECT command completed successfully. 
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DB20000I Тһе SQL DISCONNECT command completed successfully. 


5.2.5.4 SHOW CONNECT 
Below is the result of а SHOW CONNECT command. 


С” E 


Status of Connected SQL/DS Users 1997-04-28 15:05:11 
Checkpoint agent is not active. 
User Agent: 1  User-ID: CLBOEVM1 SQL-ID: CLBOEVM1 
is R/W APPL 6ВЕ9 
Agent is processing and is in communication wait. 
State started: 1997-04-28 15:05:08 
Conversation started: 1997-04-28 15:05:05 
LUWID: DEIBMIP1.IPIP110B.53E26433A320.0001 
EXTNAM: DB2BP.EXE 01260001 
Requester: DDCS/2 V3.1.0 ағ STATION2 
Protocol: DRDA 2 Phase Commit 
Package: NULLID.SQLC2BD3 Section: 201 
User Agent: 2 User-ID: CLBOEVM1 SQL-ID: CLBOEVM1 
is R/O APPL 6BEB 
Agent is processing an SQL/DS operator command. 
State started: 1997-04-28 15:05:11 
Conversation started: 1997-04-28 15:02:16 
LUWID: DEIBMIP1.*IDENT.AE94270CF109.0001 
EXTNAM: CLBOEVM1.1 
Requester: SQLDS/VM V4.1.0 at BOEVMCT1 
Protocol: SQLDS 
2 SQL/DS users are active. 
0 SQL/DS users are waiting. 
0 SQL/DS users are inactive. 
3 SQL/DS agents are available. 
144 SQL/DS user connections are available. 
ARIOO65I SQL/DS operator command processing is complete. 


5.2.5.5 SHOW INDOUBT 
Below is the result of a SHOW INDOUBT command issued after forcing agent 1 
by the operator. 


= > 


show indoubt 
TRANID: 1 User ID: CLBOEVMI 

is prepared for COMMIT or ROLLBACK 
LUWID: DEIBMIP1.1P1P110B.53E26433A320.0001 
EXTNAM: DB2BP.EXE 01260001 
Requester: DDCS/2 V3.1.0 at STATION2 
Package: NULLID.SQLC24D0 Section: 201 
PTC State started: 1997-04-28 10:18:13 
Heuristic state started: N/A 
Damage: No 
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Chapter 6. DB2 Solution for WWW Internet/Intranet 


In this chapter we will explore the DB2 WWW (World Wide Web) component of 
the Internet Connection Server. Here you will find some WWW connection 
macros, sample applications, Internet/Intranet connection setup and more. The 
solution is only a part of a complete Intranet application. For the implementation 
on your environment you need practical knowledge of networks, databases, 
HTML (HyperText Markup Language) and the operating systems involved. 


6.1 DB2 WWW Overview 


DB2 Server for VSE & VM 
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Figure 112. DB2 WWW Scenario 


The DB2 WWW Scenario describes the possibilities to access databases and 
applications on multiple platforms. 


In this sample application there is one DB2 WWW Gateway and different DB2 
servers on the platforms VSE&VM, AIX, Windows NT and OS/2. The DB2 WWW 
Gateway manages the database access on the different platforms and also 
manages the HTTP (HyperText Transfer Protocol) protocol. The access to the 
DB2 WWW Gateway from the client is via Web Browser. 
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Today the Internet is the fastest growing communication medium and currently 
has more than 40 million users. The Intranet is а special kind of Internet. For 
both solutions there is a DB2 connectivity available. 


The Intranet works with Internet functions (for example, HTTP) in a local 
environment. Likewise you can include all benefits from your local LAN 
environment. 


If you plan to provide information on the Internet/Intranet the most important 
setup for you to do is to specify the required connectivity of your server system 
to the Internet/Intranet. Because the Internet provides а worldwide service, 
access to your information is required 24 hours а day. 


However, the basic concept of the Web with DB2 WWW connection is quite 
simple and depends on some basic principles: 

* Hypertext Transfer Protocol Daemon (HTTPD) 

* Hypertext Markup Language (HTML) 

* Hypertext Transfer Protocol (HTTP) 

* Uniform Resource Locator (URL) 


* DB2 WWW macro (CGI programs Common Gateway Interface) 
Information about the Web can be found at: 


http://www.w3.org 


6.2 DB2 WWW Connection Concept 


DB2 World Wide Web Connection gives you the full power of HTML and the 
versatility of SQL to access DB2 databases. The DB2 World Wide Web 
Connection makes your database information available through the Internet or 
Intranet. 


For HTML information and DB2 WWW Connection information: 


http://www.software.ibm.com/data/db2/db2wgafs.html 
and 
http://www.ncsa.uiuc.edu/General/Internet /WwW/HTMLPrimer.html 


DB2 World Wide Web Connection is a Web server gateway to access DB2 and 
other databases. An application programmer writes macros, which are stored on 
the Web server, letting customers query databases using HTML forms. The 
results of the query are displayed on the Web browser. 


6.2.1 DB2 WWW Connection Environment 
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The process is transparent to people using the application because the DB2 
WWW macros are invoked as апу CGI program. To run the application, they just 
need to submit the completed form. 


A DB2 WWW macro is a file containing HTML and SQL and usually contains four 
or more sections: 
1. A DEFINE section to define variables used in the macro. 


2. An HTML input section to receive input from the client Web browser to place 
in the SQL query. 
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3. An SQL section to define the query to send to the database. 


4. An HTML report section to invoke the SQL query and display the results to 
the client Web browser. 


If you are familiar with HTML and SQL, you are able to write such а macro. 


6.22 DB2 WWW Server and Client Runtime Environment 


RUNTIME ENVIRONMENT 


Network 
DB2 Access 


User 


Environment Server Environment 


Figure 113. Runtime Environment 


For the user runtime environment you need a browser and a connection to the 
TCP/IP network. For the server runtime environment you need a Web server, 
DB2 WWW Gateway and access to the database. 
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6.3 Internet/Intranet Connection Server Installation and Configuration for AIX 


Figure 114. HTTP Server and Client 


The Hypertext-Model shows the relation between client runtime layer, the server 
storage layer and the application component layer. 


On the client there is а Web browser running. The Web browser has а 
connection to the Web server and also creates the GUI interface of the Web 
browser. The Web server has different links and anchors to applications, files 
and databases on the same server or on different servers. The protocol between 
the client and the server is the HyperText Transfer Protocol (HTTP). The 
language to use this protocol is the HyperText Markup Language (HTML). With 
HTML you can write Internet/Intranet applications. For information to install the 
server and so on, see the following sections. 


6.3.4 Hardware and Software Requirements 


A RISC System/6000 or IBM Power Series Family with AIX 4.1.3 or higher and 
approximately 6MB of free disk space is required. 


Any communication hardware adapter that supports the TCP/IP protocol stack for 
access to a network can be used. 


6.3.2 Installation of the IBM Connection Server 
To install software using SMIT, complete the following steps: 


1. Be sure the hostname command returns the correct host name. 
2. Enter: 


smitt install latest 


wo 


. Select the input device (F4 key). 
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4. Press the F4 key on the Software to Install option to display a list of 
packages you can selectively install. 


5. Select the software package. 


6.3.3 Starting and Stopping the IBM Internet Connection Server 


To start the server: 
startsrc -s httpd 
To stop the server 
stopsrc -s httpd 
The rc.httpd script is stored in the directory /etc. 


6.3.4 Access the IBM Internet Connection Server 
After the installation is complete, use a browser to access the server home 
page. 
The Uniform Resource Locator (URL) is: 
http: //serverhostname/ 
Example: 
http ://itsol.sw.boeblingen. ibm.com/ 
The default location for the directory is: 


/usr/Ipp/internet/server root/pub 


6.3.5 Minimum Configuration for the Internet Connection Server for AIX 


The Configuration Forms allow you to set up and configure the IBM Internet and 
Connection Server. 


Note: After the first installation you need a user ID and a password. 


Default settings: 


userid : webadmin 
password : webibm 


Note: Please change the default settings. 
1. Step: BASIC 
BASIC - Specify required settings 
Specify the host name of the computer on which the server is installed 


Example: 


| Host name : itsol.sw.boeblingen.ibm.com | 


The default port number should be the well-known HTTP port number (80), or 
a port number above 1024. (This port number is a recommendation from the 
Internet Organization.) 


Apply your changes with the apply button. 
2. Step: REQUESTING MAPPING 
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. Step: GATEWAYS 


REQUESTING ROUTING - Rules 


Specify map, pass, fail, redirect and exec rules for associating and routing а 
request URL to а physical file location. 


This is an additional definition to the default entries. 
Necessary definition: 
a. Action: PASS 
b. URL request template : /* 
Note: Asterisks can be used as wild cards. 
c. Replacement file path: /usr/lpp/internet/server_root/pub/* 
d. Apply your changes with the apply button. 


Example (possible layout): 


ag > 


Index Action Request Template Replacement File Path 


1 Pass /* /usr/lpp/internet/server root/pub/* 


9.164.178.103 


DB2 GATEWAY CONFIGURATION 


Use this set of forms to control how your various gateways are configured to 
work with the IBM Internet Connection Server. 


You must enter the following entries for the DB2WWNW.INI file. 


Example: 


DB2WWW Macro file : /usr/lpp/internet/db2www/macro 


DB2WWW Bind file : /usr/Ipp/internet/server root/cgi-bin/db2sql .bnd 


Application that owns DB2WWW tables: dbadmin1 
Note: The name <dbadmin1> is the Instance Name of the database. 


These entries are necessary for the IBM Internet Connection Server to know 
where the DB2WWW macro files and bind files are stored and what the DB2 
instance is called. 


Note: When the definitions are complete, you must shut down and restart 
your gateway code locally, for these changes to take effect. 


All another functions can use the default settings for full functionality. If you 
need Access Control, Security, Proxy and so on, you can customize your 
server by modifying the forms. 


. Step: INITPAGE WELCOME PAGE (optional) 


CHANGE THE DEFAULT WELCOME PAGE 


By default the first document (or welcome page) that is displayed in a 
directory of HTML files is named index.html 


Change this document to reflect your own welcome page. 
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Insert your HTML document at first. Normally the file must be stored in the 
directory /usr/Ipp/internet/server root/pub/ 


Apply your changes with the apply button. 


Note: For more Information see the User's Guide SC31-8194, IBM Internet 
Connection Server Version 1.0 for AIX User s. 


6.4 World Wide Connection Setup with IBM 8235 


6.4.4 World Wide Connection Overview 


World Wide Connection with IBM 8235 


Web-Browser and E WAN | 
Dial-In Client | j 
| И, Modem/ 
af 
м ISDN 


Figure 115. World Wide Connection Overview 


The World Wide Connection with IBM 8235, is an easy way to connect а remote 
LAN environment. In spite of the remote access, this is а closed system for your 
company. 


6.4. Hardware/Software Requirements 
For a connection to LAN topologies via a WAN connection you need a Dial-In 
Server, an analog modem or ISDN and the Dial-In software. You need also the 
TCP/IP protocol for the Intranet solution and a World Wide Web Browser. 


Example: 


For the application in this case you need the following: 

С - 
IBM 8235 - 001 Model with serial Ports 

Analog Modem for the 8235 

Dial-In software for the Client 0S/2 

PCMCIA GSM-Card and Mobil-Phone 

Notebook with PCMCIA slot 

TCP/IP protocol 

World Wide Web Browser / Netscape 
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6.4.3 Setting Up the IBM Dial-In Server/Client Configuration 


8235 server Ethernet 


Async Dial 
Token-Ring 


Figure 116. Dial-In Server/Client Configuration 


The remote LAN environment is called dial-in. The remote workstation initiates а 
connection to the local LAN environment via WAN communication. The remote 
workstation participates on the local LAN, it can receive and send information 
directly to the LAN attached workstations. The 8235 Dial-In server for 
Token-Ring and Ethernet is а dedicated multiport, multiprotocol remote access 
hardware server. The server supports the following multiple protocols, which the 
user can access remotely: 


* IP for TCP/IP applications 
• 802.2 LLC for 3270 and SNA/APPN 
* NetBIOS for LAN servers 
* |PX for NetWare 
For a database connection to a remote LAN database environment via TCP/IP 


with Intranet functions, you need a user on the 8235 Dial-In server where the IP 
protocol is enabled. 


Note: The main security feature in the 8235 is the user list for global settings for 
all users. User specific privileges should be defined in the user profiles. 


Install the DIAL software, for example OS/2 (overview). 
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Figure 117. Client Connection 


1. If you have not already installed Multi-Protocol Transport Services (MPTS), 
please install the MPTS with the protocol drivers you need. In this sample 
application the protocol driver is IP. 


2. To install, enter setup2 on an OS/2 command line. 


3. After the installation you have two shuttles. One shuttle enables the local 
environment (shuttle to LOCAL). The other shuttle is needed for the remote 
environment (shuttle to REMOTE). The REMOTE shuttle is for the access via 
modem or ISDN. 


4. Modem configuration and port setup is necessary. You must select the 
modem, the port and the speed in the Tools menu on the client. 


For more information, refer to the redbook /BM 8235 Dial-in Access (SG24-4816). 
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6.5 Intranet Solution Connection for Client 


6.5.1 Hardware/Software Requirements 
If you want to install the Intranet Solution Connection, you need only а network 


connection with TCP/IP and а World Wide Web Browser for each client. The 
hardware requirement is the disk space for the World Wide Web Browser. 
Example: 

* TCP/IP for each client 

* Netscape Browser for each client 


* Clients in our case: AIX, OS/2, Windows NT, Windows 95 


6.5.2 Setting Up the Client for Netscape and TCP/IP 


For all clients you have the same setup. For TCP/IP you need an entry in the 
hosts file or a domain server entry. 
Example for an AIX TCP/IP host file: 


Directory: /etc 
Entry : 9.164.178.103 its0l.sw.boeblingen.ibm.com 


For the Netscape AIX setup enter the following: 
* Click on Options 
* Click on Network Preferences 
* Click on Proxies 
* Enable the Automatic Proxy Configuration 


* Click on OK 


The setup is finished for the client. 
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6.6 DB2 Sample Application 


6.6.1 Benefits for Your Company 


The sample application we used to show a DB2 solution for WWW Internet/ 
Intranet is а real-life application ported from the IBM customer HOMAG, 
Germany. 


The application runs on various client platforms and accesses DB2 servers (VSE, 
VM, AIX, OS/2, Win NT) depending on which database server the information is 
stored. 


For example, most of the operational data is stored on VSE, AIX holds highly 
sophisticated CAD/CAM drawings which are stored in the database in BLOB 
fields. This is а mulit-platform client and server environment using enterprise 
and workstation database servers. This enables HOMAG to optimize their 
applications according to the application needs and to exploit the related 
platforms according to their strengths and special capabilities. 


This kind of application is а low cost technology. The application is very easy to 
combine with other applications. The base environment is DB2 and HTML. Both 
environments are very flexible and powerful. The big advantage on this platform 
is to deliver information in an easy way. Likewise the development is fast and 
very simple. You can also integrate а high security system on this application 
environment. 


Another significant benefit is the capability of copying the entire system or part 
thereof and applications to other partner countries considering their scalability in 
terms of system capacity. For example, HOMAG have recently copied their 
enterprise system and applications on smaller but powerful PC/390 servers and 
shipped those ready-to-use systems to other countries, interconnected through 
Internet. This is а very intelligent, cost effective business solution. 


6.6.2 About the Company HOMAG AG Schopfloch/Germany 


The company was founded in 1960 by Eugen Hornberger and Gerhard Schuler. 
The HOMAG Group is а company with twelve independently operating 
mechanical engineering companies, а management consultancy, а general 
contractor and six internationally domiciled sales and service companies. 


The group is the leading association of companies serving the woodworking and 
furniture industry as well as cabinet shops. 


The eleven producing companies achieved а turnover of DM610 million in 1996 
and the total workforce increased by the end of 1996 to 2,600. 


HOMAG Maschinenbau AG, market leader in the sizing and edge processing 
sector. The company HOMAG AG is the specialist within the HOMAG Group for 
sizing and edge banding using a variety of processing techniques, as well as for 
CNC processing centers and Homatic control systems. 


The company members are connected with leased line connections. The data 
processing system consists of an IBM 9672 R32 with 1,000 terminals, 90 
RS/6000s, five AS/400s and 500 PCs. The applications include PPS, CAD, CAM 
and Internet/Intranet solutions. The database on all systems is DB2. All 
databases have connections to one or more different databases. 
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6.6.3 Overview Sample Application 


Figure 118. Sample Application Home Page 


The sample application allows any user who can connect to the Intranet server 
to query information. The sample application is а three-tier model installation 
(that is, а local Web server with Web clients plus access to remote system or 
remote database server), the application can access DB2 data on the server with 
Distributed Database Connection Service (DDCS), Client Application Enabler 
(CAE). 


Web applications for DB2 are built with DB2 WWW Connection to allow any Web 
user with an HTML-standard Web browser to access your DB2 data without you 
having to make any changes to the existing data structure. Using HTML and 
SQL, you can build applications that query your DB2 data with standard SQL 
statements. 


The key feature of DB2 WWW Connection Version 1 is а ССІ runtime engine, 


which processes the input from HTML forms on the Web and sends SQL 
commands to a DB2 system specified in a DB2 WWW Connection application. 
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The sample application consists of macro files containing HTML input and report 
form definitions, SQL commands, and variables definitions. 


In the sample application you have one HTML page (Home Page). On this page 
you can select which kind of information you want. 


—. 


Partlist 
CAD-Drawing 
Warehouse Information 


Customer Information 


From here you can branch to the selected page. In our case the page is а DB2 


macro page. This page manages the access to the DB2 database on multiple 


platforms. 
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Figure 119. Insert the Partnumber for CAD Drawing 


On this page you can use the part number as а search criterion. The system 
looks for а server and connects to the database on VM & VSE, AIX, OS/2 or 
Windows NT. The connection depends on which database server has the 
information stored. 
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Figure 120. Result from the Selection 


On this page you see the result of the selection. It is possible for you to branch 
to the CAD drawing per mouse double click. 
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Figure 121. Show the Selected CAD Drawing 


The CAD drawing file is in GIF format and is stored in the database as BLOB 
format. It is also possible to print the drawing on your local printer. In the header 
the part number and the description of the part are shown. 


DB2 common server V2.1 or higher supports storing large objects inside the 
database. DB2 WWW stores the data retrieved from an LOB column in a file in 
the directory called TMPLOBS. This directory is located in the HTML 
subdirectory of the Internet/Intranet server installation. The DB2 WWW does not 
delete the files in the directory TMPLOB automatically. 
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6.6.4 Requirements for the Application 


For an Intranet solution you need а World Wide Web Browser on multiple 
platforms, an HTTP Server, SNA (DRDA/DDCS) and TCP/IP protocol and the DB2 


database servers and clients. 


Example: 


The sample application works with the following environment. 


4. Network-Connections: 


VM & VSE SNA/APPN (DRDA) 
Client/Server-Topology TCP/IP and SNA 


1. World Wide Web Browser : Netscape for AIX, NT, 0S/2 and 
IBM Explorer for AIX and 0S/2 


2. HTTP-Server : IBM Internet connection Server for AIX 
and DB2 WWW Connection Gateway V1.0 


3. Database-Server : DB2 for VM & VSE V5.1 (also possible V3.5) 


DB2 for AIX V2.1.1 or V5.1 
DB2 for Windows NT V2.1.1 or V5.1 
DB2 for 0S/2 V2.1.1 or V5.1 


DB2 for VM & VSE V3.5 (previously called SQL/DS) and above may 


also be used. 


6.6.5 Connecting to the DB2 Servers via SNA and TCP/IP 


These components enable the DB2 database management system to access a 
local relational database and to communicate with a remote system in an SNA. 


Client 


Server ITSO1 


TCP/IP 


Figure 122. SNA and DRDA 


DRDA Server VSE 


DRDA Server VM 


SNA needs two components which control the operation of the local node in a 


C/S network. These components are: 


1. Physical (PU) 
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Each SNA node contains a PU. The PU manages resources, such as link 
resources, and supports communication with the host. 


2. Logical Unit (LU) 


Each SNA node contains one or more LUs. An LU provides a set of functions 
which are used by transaction programs to give access to the networks. LUs 
communicate directly with local transaction programs and devices. SNA 
defines several types of LUs. LU 6.2 is used in communication between two 
programs on a peer to peer basis. The SNA describing the physical 
connection between the server and the client has to be created first. They 
only need to be created once on the server. 


Refer to 4.2.3, "VTAM Setup" on page 75 for VTAM definitions and 4.2.4, “OS/2 
Customization" on page 77 for OS/2 definitions. 


For TCP/IP support you need the Client Application Enabler to access a remote 
database server through the TCP/IP network. For the connection you need the 
target server name of the remote server system: You must define this name in 
the local hosts file. You define an entry in the service file local and on the 
remote server: These entries represent the database server and their 
associated port numbers. 


Example: 


Hosts file / AIX : 9.164.178.103 — itsol.sw.boeblingen.ibm.com 


Services file : db2instlc — 3700/tcp 
db2instli 3701/TCP 


Note: The names are case sensitive on AIX systems. 


db2instlc = connection port 
db2instli = interrupt port 


6.6.6 Intranet Solution Setup 
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For this solution you need the following prerequisites: 

1. Running TCP/IP Environment 

2. Running DDCS connection to the VM & VSE system 
3. Running DB/2 database environment on each server 


For the setup of the Connection Server Installation and Configuration, refer to 
6.6.5, “Connecting to the DB2 Servers via SNA and TCP/IP” on page 155. 


You only need an SQLBIND for the database server on the Intranet environment; 
in this case on the AIX HTTP server. 

Enter the following statements on the command line: 

1. cd /usr/Ipp/internet/server root/cgi-bin/ 

2. sqlbind db2sql.bnd <databasename> 


Example: 
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ЕШ db2sql.bnd sample | 


You must bind each server database (VM&VSE, AIX, NT, OS/2). The SQLBIND 
command has a problem, when you bind a remote database. In this case you 
must change the SQLBIND file in the directory 
/home/<dbinstance>/sqllib/misc (home/dbadmin1/sqllib/misc) at the 
following line: 


Example: 


db2 +p -v *t -s -о << EOF 
connect to $DBNAME user «userid» using «password» 


Enter your user ID and password. 


Example: 


| connect to $DBNAME user dbadminl using 5411 | 


Save your file апа do the SQLBIND for the servers. 
You can also bind the macro, when you change the authentication on the server 
and client to AUTHentication = CLIENT in the database configuration file. 


Note.: Be sure to check that the following operating system's environment 
variables are defined: 


* DB2PATH 
* DB2INSTANCE 


If these two parameters are missing the DB2 WWW product will not be 
able to work. 
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6.6.7 The HTML and the DB2 Structure 


DB2 Win NT 


DB2 
VSE & VSE 


DB2 OS/2 


Figure 123. HTML and DB2 Structure 


The HTML and DB2 structure in the sample application is a combination of HTML 
documents and DB2 WWW macros. 


The start screen for the sample application is the HTML file HOMSTART. From 
here you can branch to the HOMCAD DB2 macro. This macro selects the part 
numbers which you requested. If you click on the part number on the screen, you 
branch to the HOMCAD1 DB2 macro. This DB2 macro shows automatically the 
CAD drawing. From the HOMCAD1 screen you can branch directly to the parts 
list (HOMPART1) or to the warehouse information (HOMWARE 1). All the other 
macros work in the same way (HOMPART, HOMCUST, HOMWARE). 
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When you look at HTML documents there are certain items to which a writer of a 
Web page must conform. They are the following: 


Meta Information 
This section of the document provides information on the HTML version. 
HTML Header 


This section provides the title of the document. The text between the <title> 
and </title> tags will be the text displayed in the status line of the Web 
browser. 


HTML Body 


The body portion is the document itself. Here you provide the information and 
also define the links to other documents. 


HTML Syntax 


All HTML tags have a certain structure in common. 
* All starting tags begin with a « and end with a » 
* All ending tags begin with a «/ and end with a > 


Examples 
«HTML» ... </HTML> 
«HEAD» ... </HEAD> 


What is the Common Gateway Interface (CGI)? 


When the Web was very new each main server provided its own method to 
support server-side executable support. The main purpose of CGI is to provide a 
standardization of the way HTML documents can interact with external programs 
in terms of passing variables to these programs and retrieving the program's 
result. 


СО! is not a programming language itself. It is a simple standard to which both 
the server and the server-side executables can adhere in order to exchange 
information. In fact CGI can be used by any programming language or scripting 
language supported by the server's operating system. 
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6.7 DB2 WWW Connection Macros 


DB2 WWW macros are stored in the macro directory of the DB2 WWW 
installation directory. The extension of these macros should be D2W. 


6.7.1 Define Section 


This section is for defining the database name and other variables used in the 
macro. You must always define the variable DATABASE for each macro that 
accesses a database. 


Syntax: 


A. I 


%DEFINE varname="value” 
or 

%DEFINE( 

varnamel-"valuel" 

varname2="value2” 


0, 
%} 


The value specified сап be а numeric value or а character string. 


Example: 
(С I 
%DEFINE{ 


DATABASE=” SAMPLE” 
LOGIN="dbadmin” 
PASSWORD=” dbadmin” 


0, 
%} 


Note: There is one special problem when using TEXT entry fields within а 
DB2WWW macro to retrieve а character string from the user in а FORM 
section of the macro. When the character string issued from the user 
contains a single quote (^) the SQL statement issued from the SQL section 
of the macro will fail because the database precompiler recognizes this 
single quote as the character delimiter. 
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6.7.2 HTML Input Section 
The HTML input section contains an HTML form where you specify what you 
want from the database by entering values in the form. DB2 WWW connection 
macros do not require an HTML input section for simple queries. 


Syntax: 


%HTML INPUT( 
any valid html text 
on multiple lines 


0, 
%) 


Example: 


- 


%HTML INPUT( 

<html><title>find customer</title><center> 
<table border=0> 

<tr><td rowspan=2><img src-"/critic q.gif”></td> 


any HTML statements 


«form method-post" action-"/cgi-bin/db2www/homcust .d2w/report» 
«table border cellpadding=5> 


any HTML statements 


«/table» 

</form> 

</center> 

&copy 1997 Homag AG 
</html> 


0, 
%} 


This HTML document allows the user to search for а customer by customer 
number. 
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6.7.3 SQL Section 


You can have multiple SQL sections, but each section can contain only one SQL 
command with optional report and message declarations. Optionally, you can 
name more sections which can be called from anywhere in the HTML report 
using this section name. SQL REPORT and SQL MESSAGE are optional 
subsections that can contain any HTML. 


Syntax: 


%SQL (sql-section-name) any SQL on one line 
or 
%SQL (sql-section-name) ( 
| any SQL lines 
%SQL REPORT { 
| any valid HTML statements 
sROU 


any valid HTML statements 


де 
s 


any valid HTML statements 
di 
%SQL MESSAGE ( 


SQLCODE : “Warning ” : exit 
-SQLCODE : "error^ 


%) 
%) 
Example: 
( m 
%SQL{ 


SELECT A.TNR,A.CAD FROM 11030700 А, 11010Т00 B WHERE A.TNR=B.TNR 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO</title><center> 
<h2>Found the following CAD-Drawing:</h2> 
<h2>Select the partnumber to view its partlist |</h2> 
«table border width=100% cellpadding=5> 
%ROW} 
<tr><th>part number:</th> 
<th>description:</th> 
<tr><td colspan=5>img src="$(V2) “</td></tr> 
%) 
</table> 
<p><b>select successful. $(ROW NUM) rows selected.</b> 


The SQL Report Subsection gives you the ability to customize the query output 
using HTML formatting. If you have no SQL report subsection, а default table is 
displayed with column names at the top. 
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The SQL Message Subsection allows you to customize error and warning 
messages from SQL commands. If you place this declaration inside an SQL 
section, it applies only to the SQL command in that section. If it is outside all 
SQL sections, it is global to the entire macro. 


Example: 


%SQL_MESSAGE{ 
100 : ”<Hl>Warning :</H1><H2> No data was found</H2>” : 


%} 


6.7.4 HTML Report Section 


Here you call the SQL query. This section is executed when DB2 World Wide 
Web is started in report mode, often from the HTML input section of the macro. 


Syntax: 


ет > 


%HTML INPUT( 
any valid HTML text 


%EXEC SQL (SQL section name) 


%EXEC 501 (SQL section name) 


any valid HTML text 


oe 
Eam 


Example: 


=, I 


%HTML REPORT 
&EXEC SQL 


any HTML statements 


of 
~ 
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You can specify any HTML and include any variables from the DEFINE section in 
the HTML code. Use input from the HTML form to override variables in the 
%DEFINE section. When a ФЕХЕС SQL line is encountered, the SQL section 
matching the name or defined variable is called. Using а variable for the SQL 
section names is an easy way to allow you to select a query to perform. If you 
do not specify a section name, all unnamed SQL sections are executed in the 
order in which they appear in the macro. 


COMMENTS 


You can place comments in your macros easily. Comments must be kept 
separate from other sections in the macro: 


%{single or 
multiple lines of text %) 


Comments are usually about the macro or its contents. The terminating symbols 
96) are required. The comments can be used for update information in the 
macro. 


r—- More Examples 
For additional examples see the Web Programming Guide 
http://www.ics.raleigh.ibm.com/pub/icswpg.htm. 


This document describes two interfaces you can use to write external 
programs. 
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6.8 Invoking DB2 WWW 


6.8.1 Anchor Reference 
The anchor references are commonly called hyperlinks or simply links; you 
specify the macro name and the cmd to invoke an SQL query. You can use this 
method to make queries available that require no HTML form input, sometimes 
referred to as canned queries. 


The anchor tag «A» ... «/A» will define a link to a different location ога 
different section marked inside the same document. 


Example: 


«A href="http://<servername>/cgi-bin/db2www/homcust .d2w/report”> 
List all customer</A> 


An anchor in one document may link to а destination in: 
* The same document 
* A different document on the same server 


* A document on a different server 


6.8.2 HTML Forms 


The form method exploits the power of HTML forms so that you can get exactly 
the information that you want. For most transactions you will find it useful to call 
an input section before making the query. 


Example: 


«FORM METHOD=POST 
ACTION="http://<servername>/cgi-bin/db2www/homcust.d2w/input”> 
What customer do you want 


The servername is optional; if you access your local server the entry is not 
necessary. 
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6.9 DB2 WWW Connection Variables 


6.9.1 DB2 WWW Special Variables 


The power of DB2 WWW Connection is its ability to pass variables from HTML to 
SQL and back. Variables may be specified by yourself in the macro HTML form. 


These variables have special meanings in DB2 WWW Connection macros: 


Variables you can change in DB2 WWW: 

Variable Meaning 

DATABASE Name of the database to be accessed 

LOGIN User ID to access the database 

PASSWORD Database password associated with the LOGIN variable 
SHOWSQL Flag to show the SQL command on the report form 

DB CASE Case conversion for input to SQL command 


RPT MAX ROWS 
Max. number of rows to display on the Web browser 


TRANSACTION SCOPE 
Action for SQL to take when errors are encountered 


ALIGN If this variable is undefined, the report variables are returned with 
no leading or trailing spaces 


6.9.2 Data Security with DB2 WWW 
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The DB2 World Wide Web Connection product provides the following security 
implementations: 


* The first part is implemented through the database engine. DB2 supports a 
user ID login and password authentication mechanism which is used to 
restrict access to certain users. 


* "Internet Security” with the Internet. There are services and products that 
help you achieve the security level you want on your system. 


m More Information 


http://www.rsa.com/ 
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Chapter 7. Data Replication Implementation 


In this chapter we describe the Data Replication installation and implementation 
steps for VM and OS/2 platforms. 


Introduction 


* Provides a tool to manage and distribute data across database platforms 
while maintaining consistent, synchronized information throughout the 
enterprise. 


* You can separate query and production workloads to make the data more 
available for decision support needs thereby lessening dependencies on 
remote systems and network availability. For example, if a remote host is 
unavailable, a local copy means you still have access to the data. 


* Also, if everyone has a local database and downloads only the data they 
need, then any one local database is unaffected by the availability of any 
other local or remote database. DataPropagator Relational (DPropR) 
replication means mobile users can have the data they need and know they 
can get a customized refresh of the data when they request it. 


* Optimize network utilization and help balance system loads by reducing the 
number of queries travelling across the network at any given time. 


* Provide access to current, consistent data whenever it is needed, wherever it 
is needed. Access data when it is needed and distribute it wherever it is 
needed. 


* Improves compatibility with other database solutions for distributed data. 


* Provides a client/server enabling hub for enterprises that use VM or VSE 
operating system environments with a robust, high-performance relational 
database engine. 


* Move closer to 24 x 7 availability. 


7.1 Data Replication Implementation for VM 


Following the Program Directory you can install DpropR Capture for VM very 
easily. You have to access MAINT's minidisk 5E5 in read-only mode, апа 51D in 
multi-read mode. After this submit the command: 


e vmfins install info(nomemo env dpropr 


VMFINS27601 VMFINS processing started 
ҮМЕІМ519091 VMFINS PRODLIST created on your A-disk 
VMFINS2760I VMFINS processing complete successfully 


Figure 124. Console from VMFINS Install Info Command 


The command above will create a file named VMFINS PRODLIST on your A-disk. 
This file contains the DPropR PRODID. To install DPropR, VMFINS gives you a 
PLAN. This PLAN is named PLAN PLANINFO. 


To obtain the plan and to perform the requisite checking run: 


e vmfins install ppf 564815A2 DPROPR (plan nomemo env dpropr 
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vmfins install ppf 564815a2 dpropr (plan nomemo env dpropr 
VMFINS27671 Reading VMFINS DEFAULTS B for additional options 
VMFINS27601 VMFINS processing started 
VMFINS2601R Do you want to create an override for :PPF 564815A2 DPROPR 
:PRODID 564815A2%DPROPR? 
Enter 0 (No), 1 (Yes) or 2 (Exit) 


VMFINS2603I Processing product :PPF 564815A2 DPROPR 

:PRODID 564815A2%DPROPR 

VMFREQ2805I Product :PPF 564815A2 DPROPR :PRODID 564815A2%DPROPR 
has passed 

requisite checking 

VMFINT2603I Planning for the installation of product :PPF 564815A2 
PROPR 


i=] 


:PRODID 564815A2%DPROPR 

VMFRMT27601 VMFRMT processing started 

VMFRMT27601 VMFRMT processing completed successfully 
VMFINS2760I VMFINS processing completed successfully 
Ready; T=5.85/6.19 09:14:40 


Figure 125. Console from VMFINS Command 
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kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


EERE VMFINS INSTALL USERID: DATAPROP хк» 
FOGG КК КККК КККК КККК КККК КККК КККК КККК К КККК ICI IC I IO ICI TOR III TI IR I AK К 
EREE Date: 03/14/97 Time: 09:14:21 KERE 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkxk 


VMFINS21951 VMFINS INSTALL PPF 564815A2 DPROPR ( SYSTEM VM SIDISK 51D 
SIMODE D PLAN NORESOURCE LINK DFNAME USER DFTYPE DIRECT 
DFMODE * NOMEMO ADD ENV DPROPR 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


x Requisite Planning Information d 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
* PPF: 564815A2 DPROPR PRODID: 564815A2%DPROPR Е 
* DATE: 03/14/97 TIME: 09:14:21 USERID: DATAPROP * 


eek eek eee ee eee hehehe he hehe e e e e e e e e e e e e e e ee eee hehehe hehehe hehe e e e e e e e e e e e e ee e eee eee ne 


VMFREQ2805I Product :PPF 564815A2 DPROPR 
:PRODID 564815A2%DPROPR has 


passed requisite checking 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


Ж Resource Allocation Planning Information * 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkĘk 
А РРЕ: 564815A2 DPROPR PRODID: 564815A2%DPROPR * 
* DATE: 03/14/97 TIME: 09:14:21 USERID: DATAPROP * 


eek eee e ee ee ehe hehehe hehe hehe e e e e e e e e e e e e e e ee ee ehe hehehe hehe he he e e e e e e e e e e e e ee eee ee e 
eek eek ee eee ee hehehe hehe hehe e e e e e e e e e e e e e e e ee ee hehehe hehehe he he he e e e e e e e e e e ee e eee eee e 


Resource requirements for product 564815A2 component DPROPR 


eee ee eee eee hehehe hehehe he he e e e e e e e e e e e e e e e ee ee hehehe hehehe he he he e e e e e e e e e e e e e eee eee e 


OWNER: 564815A2 


TARGID: 191 
SIZE: 600 
BLKSIZE: 4K 
FORMAT: CMS 


RECOMPED: 10 
PREFERRED: М0 
SEPARATED: NONE 


TARGID: 2C2 
SIZE: 150 
BLKSIZE: 4K 
FORMAT: CMS 


RECOMPED: 10 
PREFERRED: М0 
SEPARATED: NONE 


TARGID: 2D2 
SIZE: 600 
BLKSIZE: 4K 
FORMAT: CMS 


RECOMPED: 10 
PREFERRED: М0 
SEPARATED: NONE 


TARGID: 2A2 
SIZE: 150 
BLKSIZE: 4K 
FORMAT: CMS 


RECOMPED: 10 
PREFERRED: М0 
SEPARATED: NONE 
cont... 


Man 


Figure 126. PLAN PLANINFO File Generated by VMFINS Command 
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...Cont 

TARGID: 2A6 
SIZE: 150 
BLKSIZE: 4K 
FORMAT: CMS 
RECOMPED: NO 
PREFERRED: NO 
SEPARATED: NONE 

TARGID: 200 
SIZE: 300 
BLKSIZE: 4K 
FORMAT: CMS 
RECOMPED: NO 
PREFERRED: NO 
SEPARATED: NONE 

TARGID: 2B2 
SIZE: 300 
BLKSIZE: 4K 
FORMAT: CMS 
RECOMPED: NO 
PREFERRED: NO 
SEPARATED: NONE 

OWNER: CAPTMACH 

TARGID: 191 
SIZE: 150 
BLKSIZE: 4K 
FORMAT: CMS 
RECOMPED: NO 


PREFERRED: NO 
SEPARATED: NONE 


TARGID: 300 
SIZE: 300 
BLKSIZE: 4K 
FORMAT: CMS 


RECOMPED: NO 
PREFERRED: М0 
SEPARATED: NONE 


REPLACE USER: 564815A2 
USER 564815A2 XXXXX 24M 32M G 
ACCOUNT XXXXX 
IPL CMS 
MACHINE XA 
CONSOLE 009 3215 
SPOOL 00С 2540 READER * 
SPOOL 00D 2540 PUNCH А 
SPOOL OOE 1403 A 
LINK MAINT 0190 0190 RR * CMS system disk 
LINK MAINT 019D 019D RR * help disk 
LINK MAINT 019E 019E RR * Product code disk 


Figure 127. PLAN PLANINFO File Generated by VMFINS Command 
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cont... 


...Cont 
LINK MAINT 051D 051D MR * VMSES/E software inventory disk 
LINK MAINT 05E5 05E5 RR * VMSES/E code 
LINK CAPTMACH 300 300 MR 
LINK SQLMACH 195 195 RR 


REPLACE USER: CAPTMACH 
USER CAPTMACH XXXXX 24M 32M G 
ACCOUNT XXXXX 
IPL CMS 
MACHINE XA 
CONSOLE 009 3215 
SPOOL 00C 2540 READER * 
SPOOL 00D 2540 PUNCH A 
SPOOL OOE 1403 A 
IUCV *IDENT CAPTURE LOCAL 
LINK MAINT 0190 0190 
LINK MAINT 019D 019D 
LINK MAINT O19E 019Е 
LINK SQLMACH 195 195 


/% 
/% 
/% 
/% 
/% 


Add links for the 
Add links for the 


RR * CMS system disk 

RR * help disk 

RR * Product code disk 

RR 

Language Environment run time libraries */ 
DB2 for VM data base being captured: */ 


- Database directory disk (default is SQLMACH 200) */ 


- Database log disk(s) (default is SQLMACH 201 for single log) */ 


(add both if dual 


logging is used) */ 


Figure 128. PLAN PLANINFO File Generated by VMFINS Command 


With the PLAN PLANINFO file you can alter your USER DIRECTORY to create the 
CAPTMACH user ID which will run Capture for VM. 


You have to supply the link for the C/370 run time library in the above. 
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After running planning and making the required modifications to the USER 
DIRECTORY, you can now install the DpropR Capture for VM: 


e vmfins install ppf 564815А2 DPROPR (nomemo nolink env dpropr 


vmfins install ppf 564815a2 dpropr (nomemo nolink env dpropr 
VMFINS27671 Reading VMFINS DEFAULTS B for additional options 
VMFINS27601 VMFINS processing started 
VMFINS2601R Do you want to create an override for :PPF 564815A2 DPROPR 
:PRODID 564815A2%DPROPR? 
Enter 0 (No), 1 (Yes) or 2 (Exit) 


VMFINS2603I Processing product :PPF 564815A2 DPROPR 
:PRODID 564815A2%DPROPR 


VMFREQ2805I Product :PPF 564815A2 DPROPR :PRODID 564815A2%DPROPR 
has passed 

requisite checking 
VMFINT26031 Installing product :PPF 564815A2 DPROPR 


:PRODID 564815A2%DPROPR 
MFSET27601 VMFSETUP processing started for 564815A2 DPROPR 
MFUTL2205I Minidisk|Directory Assignments: 
String Mode Stat Үдеу Label/Directory 
MFUTL2205I LOCALSAM E R/W 2C2 РАТ2С2 
MFUTL2205I APPLY F R/W 2A6 | DAT2A6 
MFUTL2205I G R/W 2A2 РАТ2А2 
MFUTL2205I DELTA H R/W 202  DAT2D2 

I 

J 

K 

А 


== 


MFUTL2205I BUILDO R/W 200 DAT200 
MFUTL2205I BASE R/W 282 РАТ2В2 
MFUTL2205I SYSTEM R/O 195  SRV195 
MFUTL2205I -------- R/W 191 DAT191 
MFUTL2205I -------- B R/O 5E5  MNT5E5 
MFUTL2205I -------- D R/W 51D  DAT51D 
MFUTL2205I -------- S R/O 190 MNT190 
MFUTL2205I -------- Y/S R/O 19E  MNTI9E 
MFSET27601 VMFSETUP processing completed successfully 
MFREC27601 VMFREC processing started 

MFREC1852I Volume 1 of 1 of INS ENVELOPE 9700 
MFREC1851I (1 of 6) VMFRCAXL processing AXLIST 
MFRCX2159I Loading 0 part(s) to DELTA 2D2 (Н) 
МҒВЕС18511 (2 of 6) VMFRCPTF processing PARTLST 
MFRCP2159I Loading 0 part(s) to DELTA 2D2 (Н) 
МҒВЕС18511 (3 of 6) VMFRCCOM processing DELTA 
MFRCC2159I Loading 0 part(s) to DELTA 202 (H) 
MFREC18511 (4 of 6) VMFRCALL processing APPLY 
MFRCA2159I Loading part(s) to APPLY 2A6 (F) 
MFRCA2159I Loaded 1 part(s) to APPLY 2A6 (F) 
MFREC1851I (5 of 6) VMFRCALL processing BASE 
MFRCA2159I Loading part(s) to BASE 2B2 (J) 
MFRCA2159I Loaded 16 part(s) to BASE 2B2 (J) 
МҒВЕС18511 (6 of 6) VMFRCALL processing BUILD 
MFRCA2159I Loading part(s) to BUILDO 200 (I) 
MFRCA2159I Loaded 11 part(s) to BUILDO 200 (I) 
MFREC27601 VMFREC processing completed successfully 
MFINT26031 Product installed 

MFINS27601 VMFINS processing completed successfully 
eady; T=17.09/17.87 09:15:58 


2а =є©=<є=є=<є <<< <<< <<< <<< <<< <<< <<< <<< << << 


Figure 129. DPropR Installation Console 


You should have no errors from the installation process. If an error occurs 
correct it and start again. 
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The following command will build any parts that were not built on the installation 


(if any) and update the Software Inventory build status table showing that the 
product 564815A2 has been built. 


* vmfins build ppf 564815A2 DPROPR (serviced nolink 


vmfins build ppf 564815a2 dpropr (serviced nolink 

VMFINS27671 Reading VMFINS DEFAULTS B for additional options 
VMFINS27601 VMFINS processing started 

VMFINS2603I Processing product :PPF 564815A2 DPROPR 

:PRODID 564815A2%DPROPR 

VMFREQ2805I Product :PPF 564815A2 DPROPR :PRODID 564815A2%DPROPR 
as passed 


I 


requisite checking 

VMFINB26031 Building product :PPF 564815A2 DPROPR 

:PRODID 564815A2%DPROPR 

MFSET27601 VMFSETUP processing started for 564815A2 DPROPR 
MFUTL2205I Minidisk|Directory Assignments: 

String Mode Stat Vdev Label/Directory 


== 


VMFUTL2205I LOCALSAM E R/W 2C2  DAT2C2 
VMFUTL2205I APPLY F R/W 2A6 ПАТ2А6 
VMFUTL2205I G R/W 2A2  DAT2A2 
VMFUTL2205I DELTA H R/W 202  DAT2D2 
VMFUTL2205I BUILDO I R/W 200  DAT200 
VMFUTL2205I BASE J R/W 282 РАТ2В2 
VMFUTL2205I SYSTEM K R/O 195  SRV195 
VMFUTL2205I -------- A R/W 191 РАТ191 
VMFUTL2205I -------- B R/O 5E5  MNT5E5 
VMFUTL2205I -------- D R/W 51D  DAT51D 
VMFUTL2205I -------- S R/O 190  MNT190 
VMFUTL2205I -------- Y/S R/O 19E MNT19E 
VMFSET27601 VMFSETUP processing completed successfully 
VMFBLD2760I VMFBLD processing started 

VMFBLD18511 Reading build lists 

VMFBLD21821 Identifying new build requirements 
VMFBLD21821 No new build requirements identified 
VMFBLD2179I There are no build requirements matching your request at this 


time. 

No objects will be built 

VMFBLD21801 There are 0 build requirements remaining 
VMFBLD2760I VMFBLD processing completed successfully 
VMFINB2603I Product built 

VMFINB21731 No verification exec found for this product 
V 

R 


MFINS2760I VMFINS processing completed successfully 
eady; T=9.98/10.41 09:20:21 


Figure 130. Console from VMFINS Build Command 
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To load the DPropR Capture for VM package, the ASNPLOAD EXEC must be 
used. This exec uses the DBS Utility program RELOAD PACKAGE in multiple 
user mode to load the preprocessed module SQLDBA.ASNLMAIN. The 
ASNPLOAD EXEC assumes that the user ID is SQLDBA and that the password is 
SQLDBAPW. If the password has been changed, it should be reassigned before 
running ASNPLOAD. Alternatively, update the CONNECT statement in the 
ASNPLOAD EXEC to specify the current password for SQLDBA. 


The syntax required for ASNPLOAD is: 
* ASNPLOAD dbname 


where dbname is the name of the database to which you are loading the 
package file. You must access the production minidisk of the database before 
invoking ASNPLOAD. 


TE a 


asnpload srvvm01 
ARIO717I Start SQLINIT EXEC: 03/27/97 18:58:01 CET. 
ARIO320I The default server name is SRVVMOL. 
ARI07961 End SQLINIT EXEC: 03/27/97 18:58:02 CET 
ARIO717I Start SQLDBSU EXEC: 03/27/97 18:58:02 CET. 
ARIO659I Line-edit symbols reset: 

LINEND=# LINEDEL-OFF CHARDEL=OFF 

ESCAPE=OFF TABCHAR=OFF 
ARIO655I Input file (SYSIN): $DPRTEMP $DPRTEMP A 
ARIO656I Message file (SYSPRINT): PRINTER 
ARIO320I The default server пате is SRVVMOL. 
ARIO6631 FILEDEFS in effect are: 
ASNCCP DISK 200 
SYSPRINT PRINTER 
ASNLMAIN DISK ASNLMANM MACRO F1 
ARISQLLD DISK ARISQLLD LOADLIB Q1 
SYSIN DISK $DPRTEMP $DPRTEMP A1 
PRT FILE 0021 SENT FROM CAPTPROP PRT WAS 0021 RECS 0021 CPY 001 A HOLD 
NOKEEP 
ARIO809I ...No errors occurred during command processing. 
ARIO808I DBS processing completed: 03/27/97 18:58:07. 
ARIO660I Line-edit symbols restored: 

LINEND=# LINEDEL=¢ CHARDEL=@ 

ESCAPE-" TABCHAR=“ 
ARIO796I End SQLDBSU EXEC: 03/27/97 18:58:07 CET 
DPROPR Capture Package ASNLMAIN created/recreated 
Ready; Т-0.48/0.58 18:58:07 
Ready; T=0.01/0.01 18:58:07 


Figure 131. Console from ASNPLOAD Command 
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f > 


ARIO801I DBS Utility started: 03/27/97 18:58:03. 

AUTOCOMMIT = OFF ERRORMODE = OFF 

ISOLATION LEVEL = REPEATABLE READ 
------ > CONNECT "SQLDBA ^" IDENTIFIED BY ********; 
ARI8004I User SQLDBA connected to server SRVVMOL. 
ARIO500I SQL processing was successful. 
ARI0505I SQLCODE = 0 SQLSTATE = 00000 ROWCOUNT = 0 
------ » RELOAD PACKAGE (ASNLMAIN) REPLACE 
------ > INFILE(ASNLMAIN) ; 
ARI0852I RELOAD PACKAGE processing started. 
ARIO8681 DNAME-ASNLMAIN RECFM-FB RECSZ-80 BLKSIZE-80 
ARI80111 Package SQLDBA.ASNLMAIN was replaced. 
ARIO08531 RELOAD SQLDBA.ASNLMAIN successful. 
------ > COMMIT WORK; 
ARIO500I SQL processing was successful. 
ARIO505I SQLCODE = 0 SQLSTATE = 00000 ROWCOUNT = 0 
ARI0802I End of command file input. 
ARI8997I ...Begin COMMIT processing. 
ARIO811I ...COMMIT of any database changes successful. 
ARIO809I ...No errors occurred during command processing. 
ARIOS808I DBS processing completed: 03/27/97 18:58:07. 


Figure 132. Listing from DBSU Command Invoked by ASNPLOAD EXEC 


7.2 Data Replication Implementation for OS/2 


Now that you have installed the DpropR Capture for VM, you can proceed with 
the OS/2 installation. 


Refer to Appendix C, "Data Replication Implementation for OS/2" on page 255 
for installation/migration of the DB2 Universal Database including DpropR 
installation. 


7.2.1 Defining the Replication Requirements 
Data Replication can be administered from the DB2 Universal Database for OS/2. 
To install the Replication Administration, a source database on VM or VSE, a 
target database on an OS/2 system, and two administrators defined in UPM (ASN 
and USERID (the default)) are assumed. 


Open the IBM DATABASE? - Icon View and click on Server Administration as 
shown below. 


2 Installation Li Serine 


Figure 133. IBM DATABASE? Icon View - Select the Server Administrator Icon 


Chapter 7. Data Replication Implementation 175 


176 


Select Control Center. This will open а screen where you will see your database 
system on all platforms that you cataloged in the DDCS Gateway. 


Figure 134. Server Administration Icon View - Select the Control Center Icon 


7.2.1.1 Selecting the Source Data 

You can choose а table to replicate. This is called the Replication Source. Click 
with the right mouse button on the table you want to replicate. In our case we 
choose to replicate a table called USRTO17. TEST SOURCE. This action will open 
a menu and you click to Define a Replication Source. Another menu will open. 
Choose Custom. 


SULDBA 
SULDBA 
SULDBA. 
SBLLBA 


SPUDRANT |o PROJECT 
: : ROL TNE: 


"STOKE: QUERIES" 
STSLANGUARE 


15 MOT 


SYSTERTT 


Figure 135. Control Center Tree 


From the Available Columns list, you can select the columns for which you want 
to change the values. For the columns that you don't want to replicate, clear the 
Define as source check box. This specifies that the columns you selected are 
unavailable as source columns during subscription and cannot be replicated. 


You can also select the Capture before-image check box to replicate the source 
column before-image to the target table. The before-image column is а copy of a 
column before it is updated. 


In our case we just select OK. 
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You will be asked when to run the job that will create the replication table. 
Select Save SQL to file and run later. Then you need to supply а name and click 
OK. 


You will receive an information message. Just click OK. 


Click with the right mouse button on the Replication Sources or Replication 
Subscription, and select Run SQL files. This will open another screen for you to 
select the SQL file stored previously. Select it and click OK. Finally you will 
receive an information message. Again click OK. You can click with the right 
mouse button and ask to refresh the list of Replication Sources, to see the one 
you created. 


Figure 136. Replication Source List 


7.2.1.2 Defining the Target Data 

To define the Replication Subscription, click the right mouse button on the 
Replication source you have. This will open а menu and you will choose Define 
Subscription. А subscription defines the structure of а target table, and how the 
Apply program replicates data to the target table: when, how often, which 
enhancements, all data or changed data. It also defines the type of target table 
to be created, such as а user copy table or а replica. 
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Figure 137. Selecting Relational Subscription 


On the next screen you can specify the Subscription name, the Target server and 
the Apply qualifier. You can choose the name you want for the subscription 
name and apply qualifier. The target server is selected from the drop-down list. 
The apply qualifier will be used as а parameter to start the Apply program. 


S ounce table : Erste table 5 


VENN 


Figure 138. Defining Relational Subscription 


Click on the Target table name, and change the name of the target table. When 
you ask to create а Replication Subscription, the system offers you the same 
table name as the source table, and permits you to change this name. Click on 
the Advanced button. On the next screen with the right mouse button, click on 
subscribe for the column names which start with X. This will exclude these 
columns. You can maintain the columns that start with X. They are the 
corresponding before-image columns. In our test we suppressed them. We only 
want to show the after-image columns, in other words, we want the same 
structure table and data. Click now on primary key of the ROW NUMBER column 
to tell DB2 that this column will be the primary key for the replication table. 
Then click OK. 
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Figure 139. Advanced Subscription Definition Window 


7.2.1.3 Setting the Copying Schedule 

You can set the copying schedule for a subscription set using the timing 
notebook. You have several options: relative timing, event timing, triggered 
timing. 


The first two pages of the Subscription Timing notebook specify the frequency 
and start times for copying between source and target tables. The simplest 
method is to use the time-based frequency which allows the subscription to be 
run at a set interval (relative timing) or continuously. The entire subscription set 
is replicated at the same frequency. Relative timing allows you to specify an 
interval in minutes, hours, days or weeks at which the subscription set is 
replicated. 


Choosing a relative timing interval does not guarantee that the frequency will be 
exactly at that interval. 
Specifying a time-base frequency: 


1. From the Define Subscription window, select Timing. The Subscription Timing 
notebook opens. 


Select the Source to Target page of the Subscription Timing notebook. 
Specify the date and time you want the replication to start. 


Select the Time-based checkbox. 


Өө Roo То 


Choose the type of interval you want by selecting one of the radio buttons: 
Using relative timing or Continuously. 


6. Click OK. 


Before the Replication Subscription is created, you must specify a database to 
store the subscription control information. We chose to store it in VM. 
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Figure 140. Subscription Information 


You will be asked when to run the job that will create the replication table. 
Select Save SQL to file and run later. Then you have to supply а name and click 
OK. 


You will receive an information message. Just click OK. 


Click with the right mouse button on the Replication Sources or Replication 
Subscription, and select Run SQL files. This will open another screen for you to 
select the SQL file stored previously. Select it and click OK. And finally you will 
receive an information message. Again click OK. You can click with the right 
mouse button and ask to refresh the list of Replication Subscriptions, to see the 
one you created. 


Apply Identifier 
ӘНДЕРІ 


LESER 


STAS TASTA TASTA ASS SSS SSS SSS AS 


Figure 141. Replication Subscription List 
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Now we can start our replication process. Remember that when the apply 
program starts, it creates the replication table and inserts the current data from 
the source table. 


7.3 Using IBM Data Replication 
IBM Data Replication is а set of automated copy tools that copies relational data 
from sources to targets. 
This means that data can be copied: 
* Among DB2 for MVS, DB2 for OS/400, and DB2 for common servers. 


* Across platforms for MVS, VM, VSE, OS/400, AIX, HP-UX, OS/2, Windows NT, 
and Solaris operating environments. 


* On non-DB2 sources and targets through DataJoiner; specifically Oracle, 
Sybase, and other databases. 


In our case we are replicating data across VM and OS/2. We are running 
Capture for VM and Apply for OS/2. This means that our source table is on VM, 
and our target table is on OS/2. 


The figure below shows our scenario. We can replicate data between any 
database located at any server. 


APPLY 
FOR NT 


WINDOWS NT 


DB2 FOR NT SERVER 


APPC 
APPN 
APPLY 
OSE WAR FOR 05/2 
SERVER 
OS/2 WARP 
i SERVER 
UNIVERSAL DATABASE FOR OS/2 HER. 
DDCS DB2 FOR OS/2 SERVER 
GATEWAY DPROPRDB 


Figure 142. Scenario for Data Replication 


The next figure shows hypothetical databases located on VM and VSE and 
replication data to Windows NT and OS/2 Warp Server. It shows that you can 
replicate tables to one database from different sources. That means that in the 
same target database, you can have tables from one database located on VM 
and other tables from another database located on VSE. 
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SOURGE SOURCE 
DATA å 


TARGET 
DATA 


пеот/в TCP/IP 
NETBIOS 


TARGET 
DATA 


ЕА 
OS? WARP 
SERVER 


22 A 
OS/2 WARP 


SERVER 


Figure 143. Scenario for Data Replication - Database View 


Now you can see in the figure below, that if you update a row in the source 
database, the row will be replicated to the target database. In our example we 
changed the number 2 to 6 and the letter H to P. Note that they were replicated 


to the target. 


SOURCE SOURCE 
DATA 


TARGET 
DATA 


VMÆSA 


WINDOWS NT 


a 


тво TR. TCPAP 
NETBIOS 


TARGET 
2DATA 


2222 К 
OS/2 WARP шеке; m OS/2 WARP 
SERVER SERVER 


Figure 144. Scenario for Data Replication - Update 
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The next figure is similar to the previous figure. It shows that if you insert а line 


in the source database, the line will be inserted at the target database. In our 
example we inserted the number 4 and the letter L. 


SOURGE қ SOURCE 
DATA 


TARGET 


DATA 
VMÆSA 


WINDOWS NT 
DB2 FOR 


VM&VSE 


TARGET 
Ж DATA 


OS/2 WARP 
SERVER 


Figure 145. Scenario for Data Replication - Insert 


If you delete а line from the source, this line will also be deleted at the target. 
The figure below shows that we deleted the number 9 and the letter K 
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SOURCE SOURCE 
DATA с; і S 


TARGET 
; DATA 


WINDOWS NT 


TARGET 
| DATA 


OS/2 WARP 05/2 WARP 
SERVER SERVER 


Figure 146. Scenario for Data Replication - Delete 


Before we started replicating data between VM and OS/2, we had only the 
following user table on VM. 


04/07/97 TEST SOURCE PAGE 1 
ROW NUMBER TEST DATA DESCRIPTION 
1 1 THIS IS ROW 01 
2 2 THIS IS ROW 02 
3 3 THIS IS ROW 03 
4 4 THIS IS ROW 04 
5 5 THIS IS ROW 05 
Figure 147. Source Table Located on VM 
On OS/2 we had the following user table, without any data. 
f. EN 
04/07/97 TEST TARGETO1 PAGE 1 


ROW NUMBER TEST DATA DESCRIPTION 


Figure 148. Target Table Located on OS/2 


The following tables must be created before starting to replicate data. Refer to 


Appendix 


C, "Data Replication Implementation for OS/2" on page 255 for related 


information. 
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- 


СКЕАТОК 


Figure 149. Tables Created оп УМ 


ТМАМ 


E 
АР APPLYTRAIL 
АР CCPPARMS 
AP CRITSEC 

АР PRUNCNTL 
AP REGISTER 
AP SUBS COLS 
AP SUBS EVENT 
AP SUBS MEMBR 
AP SUBS SET 
AP SUBS STMTS 
АР TRACE 

АР UOW 

АР WARM START 


When you define the Replication Source and Replication Subscription, the 
Control Center creates the following tables on the target database. 


- 


СКЕАТОК 


USRTO17 


NAME 


IBMS 
I BMSN 
I BMSN 
IBMS 
I BMSN 
I BMSN 
IBMS 
I BMSN 
IBMS 
TEST 


AP CRITSEC 

АР PRUNCNTL 
AP REGISTER 
AP SUBS COLS 
AP SUBS EVENT 
AP SUBS MEMBR 
AP SUBS SET 
AP SUBS STMTS 
AP UOW 
TARGETO1 


Figure 150. Tables Created on OS/2 


Remember that there is no data in the above tables. On the host database, we 
have some tables with data. 


The next figure shows the table where the Subscription Member is stored. You 


can see the Apply Qualifier name that you chose, the Subscription Name, the 


source table name and creator and the target table name and creator. 
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- 


0%%ххх 1 


APPLY QUAL 
SET NAME 
WHOS ON FIRST 
SOURCE OWNER 
SOURCE TABLE 
SOURCE VIEW QUAL 
TARGET OWNER 
TARGET TABLE 
TARGET CONDENSED 
TARGET COMPLETE 
TARGET STRUCTURE 
PREDICATES 


1SELECT * FROM ASN.IBMSNAP SUBS MEMBR 


KRAKK 


: MMAPPO1 

: MMSBSO1 

25 

: USRTO17 

: TEST SOURCE 


0 


: USRTO17 

: TEST TARGETO1 
: Y 
: Y 


8 


Figure 151. Table: IBMSNAP_SUBS_MEMBR 


The figure below shows the parameters used by Capture. 


lSELECT * FROM ASN.IBMSNAP CCPPARMS 


ORETENTION LIMIT 


10800 


LAG LIMIT COMMIT INTERVAL PRUNE INTERVAL 


10800 30 300 


Figure 152. Table: IBMSNAP CCPPARMS 


- 


Qn 1 


TARGET SERVER 
TARGET OWNER 
TARGET TABLE 
SYNCHTIME 
SYNCHPOINT 
SOURCE OWNER 
SOURCE TABLE 
SOURCE VIEW QUAL 
APPLY QUAL 

SET NAME 

CNTL SERVER 
TARGET STRUCTURE 
CNTL ALIAS 


lSELECT * FROM ASN.IBMSNAP PRUNCNTL 


kkkkk 


: DPROPRDB 
: USRTO17 
: TEST TARGETO1 


: USRTO17 
: TEST SOURCE 


0 


: MMAPPO1 
: ММ5В501 
: SRVVMO1 


8 


Figure 153. Table: IBMSNAP PRUNCNTL 
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In the next figure you can see the names of the Capture Data tables. These 
tables are called Staging tables. 


С. > 
lSELECT * FROM ASN.IBMSNAP REGISTER 
Qux 1 kkkkk 
SOURCE_OWNER : USRTO17 
SOURCE TABLE : TEST SOURCE 
SOURCE VIEW QUAL : 0 
GLOBAL RECORD : N 
SOURCE STRUCTURE : 1 
SOURCE_CONDENSED : Y 
SOURCE_COMPLETE кү 
CD OWNER : ASN 
CD TABLE : С019970405155630 
PHYS CHANGE OWNER : ASN 
PHYS CHANGE TABLE : CD19970405155630 
CD OLD SYNCHPOINT : 

CD NEW SYNCHPOINT : 
DISABLE REFRESH 0 
CCD OWNER : 
CCD TABLE 
CCD OLD SYNCHPOINT: 
SYNCHPOINT 
SYNCHTIME 
CCD CONDENSED 
CCD COMPLETE 
ARCH LEVEL : 0201 
DESCRIPTION 
BEFORE IMG PREFIX : X 
CONFLICT LEVEL : 0 
PARTITION KEYS CHG: N 
Figure 154. Table: IBMSNAP REGISTER 
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The next figure shows the columns that have been replicated and which is the 


primary key. 


- 


Qs 


APPLY QUAL 
SET NAME 
WHOS ON FIRST 
TARGET OWNER 
TARGET TABLE 
COL TYPE 
TARGET NAME 
IS KEY 

COLNO 
EXPRESSION 
Qux 

APPLY QUAL 
SET NAME 
WHOS ON FIRST 
TARGET OWNER 
TARGET TABLE 
COL TYPE 
TARGET NAME 
IS KEY 

COLNO 
EXPRESSION 
Qux 

APPLY QUAL 
SET NAME 
WHOS ON FIRST 
TARGET OWNER 
TARGET TABLE 
COL TYPE 
TARGET NAME 
IS KEY 

COLNO 
EXPRESSION 


1 


lSELECT * FROM ASN.IBMSNAP SUBS COLS 


KRAKK 


: MMAPPO1 

: ММ5В501 

:5 

: USRTO17 

: TEST TARGETO1 
ЗА 

: DESCRIPTION 

: N 


0 


: DESCRIPTION 


kkkkk 


: MMAPPO1 

: ММ5В501 

: S 

: USRTO17 

: TEST_TARGETO1 
SUA 

: ROW NUMBER 
ү. 


1 


: ROW NUMBER 


kkkkk 


: MMAPPO1 

: ММ5В501 

:5 

: USRTO17 

: TEST TARGETO1 
: А 

: TEST DATA 

: N 


2 


: TEST DATA 


Figure 155. Table: IBMSNAP SUBS COLS 
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The next figure shows the Apply Qualifier, the Subscription, the Source server 
and the Target server. 


С. — 

1SELECT * FROM ASN.IBMSNAP SUBS SET 
Qux 1 kkkkk 

APPLY QUAL : ММАРР01 

SET NAME : ММ5В501 

WHOS ON FIRST :5 

АСТІУАТЕ E 

SOURCE SERVER : SRVVMO1 

TARGET SERVER : DPROPRDB 

STATUS : 0 

LASTRUN : 1997-04-05-18.19.54.000000 
REFRESH TIMING — : R 

SLEEP MINUTES : 4 

EVENT NAME : 

LASTSUCCESS : 1997-04-05-18.19.54.000000 
SYNCHPOINT 

SYNCHTIME : 

MAX SYNCH MINUTES : 

AUX STMTS : 0 

ARCH LEVEL : 0201 

SOURCE ALIAS 

TARGET ALIAS 


Figure 156. Table: IBMSNAP SUBS SET 


To begin replicating data, you need to start Capture for VM at Captmach and 
Apply for OS/2 in an OS/2 Window. 


To start the Capture for VM, log on CAPTMACH and invoke the ASNCCP module. 
ASNCCP has some parameters that you can use. 


COLD means that Capture purges the update information from its tables. If 
cold start is specified, Capture first deletes all rows in its changed data, 
pruning control tables, and unit-of-work tables during its initialization. COLD 
start also deletes all entries to the trace table. 


WARM means that Capture resumes processing from where it left off prior to 
shutdown, if possible. If not possible, Capture switches to a cold start. WARM 
is the default. 


WARMNS means that Capture does not automatically switch to a cold start. 
Instead, if a warm start is not possible, it issues a message and terminates, 
retaining its warm start information. 


TERM terminates Capture if DB2 Server is terminated. TERM is the default. 


NOTERM keeps Capture running when the DB2 Server is terminated. When 
the DB2 Server comes up, Capture starts in WARM mode and begins 
capturing where it left off when DB2 terminated. 


PRUNE means that Capture automatically prunes the change data and the 
unit-of-work tables that Apply has copied since the last pruning. PRUNE is 
the default. 


NOPRUNE means that automatic pruning is disabled. Capture prunes the 
changed data and unit-of-work tables only when you enter the PRUNE 
command. 


USERIDzauth name/password specifies that Capture should connect to the 
database as user ID auth name. The correct password must be provided or 
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an error will be returned. The auth name and password are both from one to 
eight characters in length. 


NOUSERID specifies that Capture connects to the database as the default 
authorization name where ASNCCP is issued. NOUSERID is the default. 


TRACE tells Capture to write an informational event trace to the Capture 
virtual machine console. 


NOTRACE no informational event trace is written to the virtual machine 
console. NOTRACE is the default. 


To start Apply at the OS/2 workstation, you must log on with the Replication 
Subscriber user ID. 


Ensure that you set the DB2 default database name to the copy server (target 
database) name as shown: 


For Version 1 of DB2 for OS/2: 

- SET SQLDBDFT=DPROPRDB 
For Version 2 of DB2 for OS/2: 

- SET DB2DBDFT=DPROPRDB 

— SET DB2INSTANCE-DB2 

Enter the ASNAPPLY command 

— ASNAPPLY MMAPPLO1 SRVVMO1 


After you start Capture and Apply, you can make a Select on the target table to 
see that it has the same lines as the source table. 


— 


04/07/97 TEST_TARGETO1 PAGE 1 


ROW NUMBER TEST DATA DESCRIPTION 


1 1 THIS IS ROW 01 
2 2 THIS IS ROW 02 
3 3 THIS IS ROW 03 
4 4 THIS IS ROW 04 
5 5 THIS IS ROW 05 


Figure 157. Target Table after Starting Capture and Apply 


Now let's insert some rows in the source table. 
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(= FA 
04/07/97 TEST_SOURCE PAGE 1 
ROW NUMBER TEST DATA DESCRIPTION 

1 1 THIS IS ROW 01 
2 2 THIS IS ROW 02 
3 3 THIS IS ROW 03 
4 4 THIS IS ROW 04 
5 5 THIS IS ROW 05 
6 6 THIS IS ROW 06 
7 7 THIS IS ROW 07 
8 8 THIS IS ROW 08 
9 9 THIS IS ROW 09 
10 10 THIS IS ROW 10 
11 11 THIS IS ROW 11 
12 12 THIS IS ROW 12 
13 13 THIS IS ROW 13 
14 14 THIS IS ROW 14 
15 15 THIS IS ROW 15 

Figure 158. Source Table Located on VM after Insert 

In the target table you will see the following. 

ze =) 
04/07/97 TEST_TARGETO1 PAGE 1 
ROW NUMBER TEST DATA DESCRIPTION 


10 10 THIS IS ROW 10 
11 11 THIS IS ROW 11 
12 12 THIS IS ROW 12 
13 13 THIS IS ROW 13 
14 14 THIS IS ROW 14 
15 15 THIS IS ROW 15 


Figure 159. Target Table after Insert to the Source 


Then let's update row number 6, changing its description. 
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- 


04/07/97 

ROW NUMBER TEST DATA 
1 1 
2 2 
3 3 
4 4 
5 5 
6 6 
7 7 
8 8 
9 9 
10 10 
11 11 
12 12 
13 13 
14 14 
15 15 


TEST SOURCE 


DESCRIPTION 


THIS IS ROW 05 


Figure 160. Source Table after Update 


Looking again at the target table, you 


PAGE 


1 


will see the following. 


= 

04/07/97 TEST TARGETO1 PAGE 1 
ROW NUMBER TEST DATA DESCRIPTION 

1 1 THIS IS ROW 01 

2 2 THIS IS ROW 02 

3 3 THIS IS ROW 03 

4 4 THIS IS ROW 04 

5 5 THIS IS ROW 05 

6 6 THIS IS THE VALUE 06 

7 7 THIS IS ROW 07 

8 8 THIS IS ROW 08 

9 9 THIS IS ROW 09 

10 10 THIS IS ROW 10 

11 11 THIS IS ROW 11 

12 12 THIS IS ROW 12 

13 13 THIS IS ROW 13 

14 14 THIS IS ROW 14 

15 15 THIS IS ROW 15 


Figure 161. Target Table after Update to the Source 


Now submit а delete command against the host database as follows: 


* DELETE FROM USRTO017.TEST SOURCE WHERE ROW NUMBER > 5 


Your source table will appear as listed below. 
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- 


04/07/97 


ROW NUMBER TEST DATA 


TEST SOURCE 


DESCRIPTION 


THIS IS ROW 01 
THIS IS ROW 02 
THIS IS ROW 03 
THIS IS ROW 04 
THIS IS ROW 05 


Figure 162. Source Table after Delete 


Your target table will appear as listed 


- 


PAGE 1 


below. 


04/07/97 


ROW NUMBER 


TEST DATA 


TEST TARGETO1 


DESCRIPTION 


THIS IS ROW 01 
THIS IS ROW 02 
THIS IS ROW 03 
THIS IS ROW 04 
THIS IS ROW 05 


PAGE 1 


Figure 163. Target Table after Delete 


Chapter 7. Data Replication Implementation 


193 


194 гвг Server VM and VSE V5R1 


Appendix A. Base Environment Overview 


The following describes the test environment on which these tests have been 
performed. 
Processor 


“ ІВМ ES/9000 9672 Model R72 


Tape Unit 
* |BM 3490 


Operating System 


* VM/ESA Version 2 Release 1 
with Minidisk Caching switched on. 


* VSE/ESA Version 2 Release 2 
VSE is running on VM. 


Database Servers 
* Tests on SQL/DS Version 3 Release 5 
• Tests on DB2 Server for VSE & VM Version 5 Release 1 


Database Layout 


The database was defined with 14 storage pools. Each table has its own 
dbspace and its own storage pool. 


Sample Table 


For the measurements of the effects of VSE extended user buffering in 3.2, "VSE 
Extended User Buffering" on page 35, a table was used with the following 
definitions: 


* dbspace with 4096 pages 

* located in storage pool 8 

* a total of 8 headerpages and 1 used page, 12% 

* a total of 2737 datapages and 2440 used pages, 89% 
• а total of 1351 indexpages and 228 used pages, 16% 
* 100,000 rows with average row length 89 


* before the reload, the dbspace was first dropped and acquired, to avoid a 
storage pool full or log full condition 
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VSE Settings 
• VSE machine with SHARE RELATIVE 100 and QUICKDSP ON 
* Total number of database pages 114212 
* Directory disk (BDISK) 80 cylinders on RAMAC (logically 3380) 
* Tape unit is 3490 


Results 


We compared SQL/DS V3.5 with DB2 Server for VSE V5.1 with extended user 
buffering in activities such as DATALOAD and RELOAD of large tables. 


With DATALOAD, we measured a large reduction in disk I/O. In an uncontrolled 
environment with many other users, we measured elapsed time reductions of 
DATALOAD and DBUS RELOAD of 15% and 25%, respectively. These numbers 
might differ in other environments. 


Other measurements such as CREATE INDEX and REORGANIZE INDEX did not 
show measurable differences in our environment. 


Table 1. Sample Measurement Results in Our Environment 


Elapsed CPU Tape I/O Disk 1/О 
Time Time 
DBSU RELOAD table on SQL/DS V3R5 1:56 0:42 374 8207 
DBSU RELOAD table on DB2 Server V5.1 1:25 0:41 404 5914 
DATALOAD table on SQL/DS V3R5 25:20 1:56 100,034 5663 
DATALOAD table on DB2 Server V5.1 21:28 1:54 100,034 5526 
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Appendix В. Client/Server Environment Used 


In this appendix you can find detailed information about the setup we did for the 
client/server environment. 


B.1 VM Definitions 


These are the User Directory definitions we used in our environment. 


For remote AR users, there is no need for a 191 minidisk as shown in item 5 on 
page 198 for user CLBOEAX1. 


B.1.1 User Directory 


1. VSE guest user MMVSEO1 


- 


ІРІ 19 


IUCV А 


OPTION 
CONSOL 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 


SPECIA 
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SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


SPECIAL 


0 


E 


USER MMVSEOL xxxxxxx 64M 240M G 


IUCV SRVVMO1 


Y 


MACH ESA 


MAXCON 500 ACCT QUICKDSP 
0009 3215 T 
0080 3270 
0081 3270 
0082 3270 
0083 3270 
0084 3270 
0085 3270 
0086 3270 
0087 3270 
0088 3270 
0089 3270 
008A 3270 
008B 3270 
008C 3270 
008D 3270 
008E 3270 
008F 3270 
0090 3270 
0091 3270 
0092 3270 
0093 3270 
0094 3270 
0095 3270 


SPOOL 000C 2540 READER * 

SPOOL 000D 2540 PUNCH A 

SPOOL 000Е 3211 A 

LINK MAINT 0190 0190 RR 

LINK MAINT 019D 019D RR 

LINK MAINT 019E 019E RR 

* 191 STARTUP DISK 

MDISK 0191 3380 2074 3 VM1V84 MW RVSE WVSE MVSE 
* DEDICATED VSE SYSTEM DASD'S (FULL PACK) 
DEDICATE 0400 038B 

DEDICATE 0401 038C 

DEDICATE 0402 038D 
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2. Installation user of DB2 Server for VM, MMDB2 


USER MMDB2 xxxxxx 32M 64M б 

CLUDE CMSUSER1 

ISK 0191 3380 0061 25 VM1V85 

SK 0193 3380 0086 180 VM1V85 
SK 0195 3380 0266 100 VM1V85 
SK 0196 3380 0366 20 VM1V85 

SK 0198 3380 0386 20 VM1V85 

SK 0199 3380 0406 20 VM1V85 

SK 051D 3380 2627 10 VM1V84 

SK 02B2 3380 0426 78 VM1V85 

SK 02C2 3380 0504 15 VM1V85 

SK 02D2 3380 0519 72 VM1V85 

SK 02A6 3380 0591 15 VM1V85 

SK 02A2 3380 0606 15 VM1V85 


m 


==<==<======== 
C UO UOUDUUUUUUGGJGCG 


3. Server machine user of DB2 Server for VM, SRVVMO1 


USER SRVVMOL xxxxxxx 32M 64M G 
INCLUDE CMSUSER1 
IPL CMS 
IUCV *IDENT SRVVMO1 GLOBAL 
IUCV ALLOW 
MACH XC 
OPTION MAXCON 150 
CONSOLE 009 3215 T MMADMI 
XCONFIG ACCESSLIST ALSIZE 1022 
XCONFIG ADDRSPACE MAXNUMBER 1022 TOTSIZE 2044G 
MDISK 0200 3380 2077 70 VM1V84 
MDISK 0201 3380 2147 70 VM1V84 
MDISK 0202 3380 2217 130 VM1V84 
MDISK 0203 3380 2347 130 VM1V84 
MDISK 0204 3380 2477 130 VM1V84 
MDISK 0191 3380 2607 20 VM1V84 
MDISK 0193 3380 986 65 VM1V8F MR 
MDISK 0195 3380 1051 30 VM1V8F MR 


4. VM AR user example, CLBOEVM1 


USER CLBOEVM1 xxxxxxx 8M 16M б 
INCLUDE CMSUSER1 
MDISK 0191 3380 751 20 VM1V85 


5. Remote AR user example, CLBOEAX1 


USER CLBOEAX1 xxxxxxx 8M 16M G 
INCLUDE CMSUSER1 
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6. AVS user, ITSOAVS 


USER ITSOAVS xxxxxxx 32M 64M б 64 
IPL GCSXA PARM AUTOLOG 
IUCV ANY 
IUCV *IDENT GATEANY GATEWAY REVOKE 
IUCV ALLOW 
MACH ESA 
NAMESAVE NETVSGOO GCSXA GCS 
OPTION COMSRV MAXCONN 20 ACCT 
CONSOLE 001Ғ 3215 T MMADM1 
SPOOL 000C 2540 READER A 
SPOOL 000D 2540 PUNCH A 
SPOOL 000E 1403 
LINK MAINT 0190 0190 RR 
LINK MAINT 019D 019D RR 
LINK MAINT 019E 019E RR 
LINK MAINT 0193 0193 RR 
MDISK 0191 3380 746 5 VM1V85 


B.1.2 AVS Detinition 


1. Profile GCS for ITSOAVS 


ек ке к кк кк КЕ КА АЕ ААА ААА kk kekk f 


/* %/ 
/* SAMPLE PROFILE GCS FOR AVS *f 
/* */ 


"Ы ааа kkk f 


Тгасе 0 

“CP SET IMSG ON’ 

“CP SET EMSG ON’ 

”CP SET RUN ON 

“CP SET РҒ01 IMMED AGW QUERY ALL’ 

"СР SET РЕО2 IMMED AGW QUERY GATEWAY ALL’ 
"СР SET PF03 IMMED AGW QUERY CNOS ALL’ 
“CP SET PF04 IMMED AGW QUERY USERID ALL’ 
“CP SET PF05 IMMED AGW QUERY CONV ALL’ 
“CP SET PF12 RETRIEVE’ 


Кек кк кек КА ЕК ЕКЕ КЕК А А АЖА (7 


/* Access the System Tools disk to make the AVS loadlibs available. */ 


ККЕ КЕ ККЕ АЕК ЕКЕ КА (7 


"ACCESS 193 С” 


Кек кк е кк кк кк КЕК КЕ КЭК КА А А dokk kkk k kkk kkk kkk f 


/* Determine mode of operation. Load AGW370 loadlib if running */ 


/* in 370 mode. Load AGW LOADLIB if running in XA mode. */ 
ТЫ ааа k kekk f 
“GLOBAL LOADLIB AGWUTIL’ /* Contains AGWGMD */ 
^ OSRUN AGWGMD’ /* AGWGMD returns 0 if running in XA mode, 
and 4 if running in 370 mode */ 
IF RC=0 THEN /* Virtual machine is in ХА mode */ 
” GLOBAL LOADLIB AGW’ 
ELSE 
exit rc 


^ LOADCMD AGW AGW’ 

”Q LOADLIB’ 

”Q LOADCMD’ 

^ AGW START’ /* Start AVS */ 
ех1ї гс 
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2. AGWPROF GCS for ITSOAVS 


/ж *] 
“AGW ACTIVATE GATEWAY IPIAITSO GLOBAL’ 


B.2 VSE Definitions 


In this section there is a copy of each CICS table definition we used in our 
environment. 


B.2.1 CICS Definitions 


1. DFHSIT 
(s ER 
DFHSIT TYPE=CSECT, * 
ABDUMP=NO, CICS SYSDMP ON ASRB TRANS ABEND* 
AKPFREQ=200, ACTIVITY KEYPOINTING FREQUENCY * 
ALT-NO, NO APPLICATION LOAD TABLE * 
AMXT=20, MAX ACTIVE TASKS % 
APPLID=IP1AMC, CICS APPLICATION NAME * 
AUTINST-(100,IESZATDX,700,0), AUTO INSTALL TERMINALS * 
BFP=NO, NO BUILT-IN FUNCTIONS % 
BMS=FULL, FULL BASIC MAPPING SUPPORT * 
CMXT=(10,10,10,10,10,10,10,10,10,10), 10 TASKS/ TRANS CL* 
COBOL2-NO, USAGE OF COBOL II APPL. PRGMS * 
DATFORM=MMDDYY, EXTERNAL DATE DISPLAY Ж 
DBP-1$, DYN. BACKOUT (NO LOCAL DLI I/F)* 
DBUFSZ=2000, DYN. ADJUSTED BY CICS i 
DCT=SP, SUPPLIED WITH VSE/ESA * 
DIP=NO, NO BATCH DATA INTERCHANGE * 
DLI-NO, NO DL/I SUPPORT x 
DTB=MAIN, CHANGE TO AUX TO SAVE VIRT STOR* 
DUMP=YES, IDUMP IN ABEND SITUATIONS * 
DUMPDS-AUTO, AUTO SWITCH DUMP DATA SETS * 
EXEC=YES, EXEC LEVEL SUPPORT ^ 
FCT=MM, SUPPLIED WITH VSE/ESA * 
GMTEXT=" VSE/ESA ONLINE’, GOOD MORNING MESSAGE TEXT * 
GMTRAN=IEGM, LOGON TRANSACTION ID Ж 
ICP=COLD, INTERVAL CONTROL PGM % 
ICV=1000, INTERVAL CONTROL EXIT TIME-MS * 
ICVR=20000, RUNAWAY TASK TIME * 
ICVS=1000, DELAY BEFORE STALL PURGE =ICV * 
ICVTSD=200, TERMINAL SCAN DELAY ы 
IRCSTRT=NO, NO INTERREGION COMMUNICATION * 
ISC-YES, INTERSYSTEM COMMUNICATION m 
JCT=NO, 0 JOURNALLING x 
LGNMSG=YES, VTAM LOGON DATA Ж 
MCT=NO, 0 MONITOR CONTROL TABLE * 
MSGLVL=2, ESSAGES ON BOTH SYSLST/SYSLOG * 
MXT=999, AX NO. OF ALL CONCURRENT TASKS* 
NLT=NO, DEFAULT LOAD ORDER FOR NUCLEUS * 
OPNDLIM=10, OPEN/CLOSE DESTINATION LIMIT * 
PCDUMP=NO, CICS SYSDMP ON ASRA TRANS ABEND* 
PCT=MM, SUPPLIED WITH VSE/ESA * 
PGCHAIN=X/, BMS CHAINING COMMAND k 
PGCOPY=COPY/, BMS COPY COMMAND x 
PGPURGE=T/, BMS PURGE COMMAND * 
PGRET=P/, BMS RETRIEVAL COMMAND * 
PGSIZE=2048, SIZE OF VIRTUAL PAGING AREA x 
PLTPI=PI, POST-INITIALIZATION PLT * 
CONT verres 
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ai 


2. DFHSNT 


END 


PLTSD=SD, 
PL1=NO, 
PPT=MM, 
PRGDLAY=100, 
PRINT-PA1, 
RAMAX-256, 
RAPOOL=10, 
SCS=16384, 
SPOOL=(YES,A, 


TD=(3,3) 9: 
TRACE- (800, ON 
TS=(,8,8) La 
TSMGSET=4, 
TST=NO, 
VTAM=YES, 
VTPRFX=V, 
WRKAREA-512, 
XLT=SP, 
XRF=NO, 
ZCP-S$, 
DUMMY - DUMMY 
DFHSITBA 


A), 


), 


SHUTDOWN PLT 

NO PL/1 SUPPORT 
SUPPLIED WITH VSE/ESA 
ONE HOUR PURGE DELAY 


PRINT WITH PAL AND TCP PRINT 
SIZE OF 1/0 AREA FOR RA 


NUMBER OF FIXED 
STORAGE CUSHION 


DEFAULT SRT 
LET CICS DETERM 


SUPPLIED WITH VSE/ESA 


-MIN OF 4 PAGES 
CICS SPOOLER ACTIVE 


RPLS 


NE STARTUP 


+ + HR 


STORAGE VIOLATION DUMP&RECOVERY* 


TERMINAL CONTRO 
THREE BUFFERS & 
TRACE TABLE (FO 
EIGHT BUFFERS & 
4 MESSAGE SET E 
NO TEMP STORAGE 
SUPPORT FOR VTA 


L PROGRAM = 
THREE STRINGS * 
R PROD. SET OFF)* 
EIGHT STRINGS * 
TRIES * 
TABLE INCLUDED * 


TERMINALS y 


CICS CLIENT 
COMMON WORK 
SUPPLIED WIT 
NO XRF SUPPO 
ALL ACCESS M 
TO END MACRO 


TERMINAL PREFIXGLTA* 
AREA OF THE CSA Е 
Н VSE/ESA % 
RT INCLUDED * 
ETHODS Е 


DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 
DFHSNT 


END 


TYPE=INITIAL 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=ENTRY ,U 
TYPE=FINAL 
DFHSNTBA 


SER 


D-CLBOEVMI , PASSWRD=X 


SERID=CLBOEVM2 , PASSWRD=X 


SER 
SER 


D=CLBOEVM3, PASSWRD=X 
D=CLBOEVM4, PASSWRD=X 


SERID=CLBOEVM5 , PASSWRD=X 
SERID=CLBOEOS1, PASSWRD=X 


SER 
SER 


D=CLBOEOS2 , PASSWRD-XI 
D=CLBOEOS3 , PASSWRD-XI 


SERID=CLBOEOS4, PASSWRD-X 
SERID=CLBOEOS5 , PASSWRD=X 


SER 
SER 


D=CLBOEAX1, PASSWRD=X 
D=CLBOEAX2 , PASSWRD=X 


SERID-CLBOEAX3 , PASSWRD=X 


SER 
SER 
SER 
SER 


D=CLBOEAX4, PASSWRD=X 
D-CLBOEAX5 , PASSWRD=X 
D-CLBOEW31 , PASSWRD-X 
D-CLBOEW32 , PASSWRD=X 


SERID-CLBOEW33 , PASSWRD-X 


SER 
SER 


D-CLBOEW34 , PASSWRD-X 
D-CLBOEW35 , PASSWRD=X 


SERID=CLBOEW91, PASSWRD-X 


SER 
SER 
SER 
SER 


D-CLBOEW92 , PASSWRD-X 
D-CLBOEW93 , PASSWRD-X 
D-CLBOEW94 , PASSWRD-X 
D-CLBOEW95 , PASSWRD-X 


SERID=CLBOEWN1, PASSWRD-X 


SER 
SER 


D-CLBOEWN2 , PASSWRD-X 
D=CLBOEWN3, PASSWRD=X 


SERID=CLBOEWN4 , PASSWRD=X 


SER 


D-CLBOEWN5 , PASSWRD=X 


А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25 
А$25М 
А$25 
А$25 
А$25М 
А$25М 
А$25 
А$25 
А$25 
А$25М 
А$25 
А$25 
А$25М 
А$25 
А$25 
А$25 


= 


= 


= 


SSSSSSSESESE SSE SESE SBE SSE SESE SEE SEB5E SEE SEE SEE52 
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3. DEFine TRansaction using ВОО (DFHPCT) 


Group 

PROGram 
TWasize 
PROFile 


STatus 


DYnamic 


TRProf 
Localq 


PRIOrity 
* TClass 


DYnamic 


TRProf 
Localq 


PRIOrity 
TClass 
ALIASES 
Alias 
TAskreq 
Xtranid 
RECOVERY 
DTimout 
Indoubt 
+ REStart 
+ ALIASES 
Alias 
TAskreq 
Xtranid 
RECOVERY 
DTimout 
Indoubt 
REStart 
SPurge 
TPurge 
DUmp 
TRACe 
SECURITY 
Extsec 
TRANsec 
RSL 
RSLC 


TRansaction 


PArtitionset 
PRIMedsize 
REMOTE ATTRIBUTES 

: No 


REMOTESystem 
REMOTEName 


SCHEDULING 
+ REMOTE ATTRIBUTES 
REMOTESystem 


REMOTEName 


SCHEDULING 


: BOEL 

: DRDA 

: ARICAXED 
: 00000 

: DFHCICST 


: Enabled 
: 00000 


: 001 


: 001 
: No 


: No 
: Backout 
: No 


0 


: Backout 


0-32767 


Enabled | Disabled 
0-65520 


No | Yes 

No | Yes 
0-255 

No | 1-10 
No | Yes 

No | Yes 
0-255 

No | 1-10 
No | 1-6800 


Backout | Commit | Wait 
No | Yes 


о | 1-6800 

Backout | Commit | Wait 
о | Yes 

о | Yes 

о | Yes 

Yes | No 

Yes | No 


о | Yes 

1-64 

0-24 | Public 

No | Yes | External 
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4. DEFine PROGram using RDO (DFHPPT) 


= 
PROGram : ARICAXED 
Group : DRDA 
Language : Assembler CObol | Assembler | C | Pli | Rpg 
RELoad : No No | Yes 
RESident : Yes No | Yes 
RS] : 00 0-24 | Public 
Status : Enabled Enabled | Disabled 
REMOTE ATTRIBUTES 
REMOTESystem 
REMOTEName 
Transid ; 
Executionset : Fullapi Fullapi | Dplsubset 
“- 
DEFine Connection using RDO (DFHTCT) 
ы 
CEDA View 
Connection : CT10 
Group : DRDA 
CONNECTION IDENTIFIERS 
Netname : IP1P10CP 
INDSys : 
REMOTE ATTRIBUTES 
REMOTESystem 
REMOTEName Б 
CONNECTION PROPERTIES 
ACcessmethod : Мат Vtam | IRc | INdirect 
Protocol : Appc Аррс | Lu61 
SInglesess : No No | Yes 
Datastream : User User | 3270 | SCs | STrfield | Lm 
RECordformat : U U | Vb 
OPERATIONAL PROPERTIES 
AUtoconnect : Yes No | Yes | All 
* INService : Yes Yes | No 
* CONNECTION PROPERTIES 
ACcessmethod : Vtam Vtam | IRc | INdirect 
Protocol : Appc Appc | 1061 
SInglesess : No No | Yes 
Datastream : User User | 3270 | SCs | STrfield | Lm 
RECordformat : U U | Vb 
OPERATIONAL PROPERTIES 
AUtoconnect : Yes No | Yes | All 
INService : Yes Yes | No 
SECURITY 
SEcurityname 
ATtachsec : Verify Local | Identify | Verify 
Bindpassword  : PASSWORD NOT SPECIFIED 
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6. DEFINE Session using RDO (DFHTCT) 


РЕ 

СЕРА View 

Sessions : CT10 

Group : DRDA 

SESSION IDENTIFIERS 

Connection : CT10 

SESSName 

NETnameq : 

MOdename : IBMRDB 
SESSION PROPERTIE 

Protocol : Appc 

MAximum : 00020 , 00010 
RECEIVEPfx 

RECEIVECount : No 

SENDPfx : 

SENDCount : No 

SENDSize : 04096 
RECEIVESize : 04096 

omitted 
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Profile Exec 


Appc | Lu61 
0-32767 


No | 1-999 
No | 1-999 


1-30720 
1-30720 


JE]. 

"СР DEFINE CTCA C22’ 

"СР COUPLE C22 VTAMESA C22’ 
TERM CON 3270 

I 400 
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B.3 Network Definitions 


The following are network definitions we used in our environment. There are 
VTAM definitions for VM and VSE. 


B.3.1 VTAM Definitions 


B.3.1.1 VTAM Definitions for VM 
1. ATCSTROO VTAMLST 


je - 


* 


SSCPID=10, 
HOSTPU=IP1PU, 
HOSTSA=10, 
NETID=DEIBMIP1, 
SSCPNAME=IP1, 
MAXSUBA=63, 
IOBUF=(230,182,3,,1,38), 
LPBUF- (24, ,2,,1,4), 
LFBUF-(,,,,1,1), 
CRPLBUF- (400, ,,,1,1), 
SFBUF-(,,,,1,1), 


P C) CT C) EST C ET CL CE CHE СЭС EO CY ec E 


SORDER-SUBAREA, SUBAREA WIRD ZUERST GESUCHT VTAM4.2 
NODETYPE=NN, APPN NETWORK NODE VTAM4.2 
APPNCOS=+ INTER, APPN COS-TABLE VTAM4.2 
BN=YES, APPN BORDER NODE FUNCTION VTAM4.2 
BNDYN=FULL, APPN BORDER NODES ADDED VTAM4.2 
CDSERVR=YES, APPN CENTRAL DIRECTORY SERVER — VTAM4.2 
CONNTYPE=APPN, APPN CONNECTION VTAM4.2 
CPCP=YES, VTAM4.2 
ISTCOSDF=ALL, VTAM4.2 
ALSREQ-NO, VTAM4.2 
XNETALS=NO, VTAM4.2 
DYNADJCP=YES, VTAM4.2 
DYNLU=YES, VTAM4.2 


NOTRACE, TYPE=VTAM 


* 
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2. COSAPPN VTAMLST 


—. 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 00002500 


* * 00005000 
* MEMBER NAME: COSAPPN * 00007500 
Ж * 00010000 
* Descriptive name: IBM-Supplied APPN Class of Service Definitions * 00012500 
* * 00015000 
* STATUS: ACF/VTAM VERSION 4 RELEASE 2 * 00018490 
* * 00020000 
* COPYRIGHT: LICENSED MATERIALS - PROPERTY OF IBM * 00022500 
Ы % 00025000 
* 5695-117 (C) COPYRIGHT IBM CORP. 1992. * 00027500 
* ALL RIGHTS RESERVED. * 00030000 
* * 00032500 
ж U.S. GOVERNMENT USERS RESTRICTED RIGHTS - * 00035000 
* USE, DUPLICATION OR DISCLOSURE RESTRICTED BY * 00037500 
* GSA ADP SCHEDULE CONTRACT WITH IBM CORP. * 00040000 
Ж * 00042500 
Å SEE COPYRIGHT INSTRUCTIONS. * 00045000 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 00047500 


CPSVCMG APPNCOS PRIORITY=NETWORK transmission priority 00050000 
LINEROW WEIGHT=30, line row weight *00150000 
NUMBER=1, line row number *00200000 
UPARM1=(0,255), user defined char 1 *00250000 
UPARM2- (0,255) , user defined char 2 *00300000 
UPARM3- (0,255), user defined char 3 *00350000 
CAPACITY (4M, MAXIMUM) , line speed *00400000 
СОЅТТІМЕ= (0,0), cost per connect time *00450000 
СОЅТВҮТЕ= (0,0), cost per byte transmitted *00500000 
PDELAY=(MINIMUM,NEGLIGIB), propagation delay *00550000 
SECURITY=(UNSECURE,MAXIMUM) security level for TG 00600000 
NODEROW NUMBER=1, node row number *00650000 
WEIGHT=5, node row weight *00700000 
CONGEST=(LOW, LOW) , congestion *00750000 
ROUTERES=(0, 31) route addition resistanc 00800000 
LINEROW WEIGHT=60, line row weight *00850000 
NUMBER=2, line row number *00900000 
UPARM1= (0,255) , user defined char 1 *00950000 
UPARM2- (0,255) , user defined char 2 *01000000 
UPARM3- (0,255) , user defined char 3 *01050000 
САРАСІТҮ= (56000, MAXIMUM), line speed *01100000 
СОЅТТІМЕ= (0,0), cost per connect time *01150000 
COSTBYTE=(0,0), cost per byte transmitted *01200000 
PDELAY=(MINIMUM,TERRESTR), propagation delay *01250000 
SECURITY=(UNSECURE,MAXIMUM) security level for TG 01300000 
NODEROW NUMBER=2, node row number *01350000 
WEIGHT=10, node row weight *01400000 
CONGEST=(LOW, LOW) , congestion *01450000 
ROUTERES= (0,63) route addition resistanc 01500000 
CONE: vasset 
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LINEROW WEIGHT=90, 

NUMBER=3, 

UPARM1= (0,255), 
UPARM2=(0,255) , 

UPARM3- (0,255) , 
CAPACITY» (19200, MAXIMUM) 
СОЅТТІМЕ= (0,0), 
СОЅТВҮТЕ= (0,0), 


PDELAY= (MINIMUM, TERRESTR) , 
ЅЕСОВІТҮ= (UNSECURE , MAXIMUM) 


NODEROW NUMBER=3, 
WEIGHT=20, 
CONGEST= (LOW, LOW) , 
ROUTERES=(0, 95) 

LINEROW WEIGHT=120, 
NUMBER=4, 

UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255), 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 


PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=4, 
WEIGHT-40, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,127) 

LINEROW WEIGHT=150, 
NUMBER-5, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3- (0,255) , 
CAPACITY» (19200, MAXIMUM) 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY- (MINIMUM, PACKET) , 


SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=5, 
WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 159) 

LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,128), 
COSTBYTE- (0,128), 
PDELAY- (MINIMUM, PACKET) , 


SECURITY» (UNSECURE , MAXIMUM) 


line row weight 
line row number 


user defined char 1 
user defined char 2 
user defined char 3 


; line speed 


cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


node row number 
node row weight 
congestion 


route addition resistance 


line row weight 
line row number 


user defined char 1 
user defined char 2 
user defined char 3 


line speed 


cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


node row number 
node row weight 
congestion 


route addition resistanc 


line row weight 
line row number 


user defined char 1 
user defined char 2 
user defined char 3 


; LINE SPEED 


cost per connect time 
cost per byte transmitte 


propagation delay 


node row number 
node row weight 
congestion 


route addition resistance 


line row weight 
line row number 


security level for TG 


user defined char 1 
user defined char 2 
user defined char 3 


LINE SPEED 


cost per connect time 
cost per byte transmitted 


propagation delay 
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security level for TG 


*01550000 
*01600000 
*01650000 
*01700000 
*01750000 
*01800000 
*01850000 
*01900000 
*01950000 

02000000 
*02050000 
*02100000 
*02150000 

02200000 
*02250000 
*02300000 
*02350000 
*02400000 
*02450000 
*02500000 
*02550000 
*02600000 
*02650000 

02700000 
*02750000 
*02800000 
*02850000 

02900000 
*02950000 
*03000000 
*03050000 
*03100000 
*03150000 
*03200000 
*03250000 
*03300000 
*03350000 

03400000 
*03450000 
*03500000 
*03550000 

03600000 
*03650000 
*03700000 
*03750000 
*03800000 
*03850000 
*03900000 
*03950000 
*04000000 
*04050000 

04100000 
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NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 
LINEROW WEIGHT=210, 
NUMBER-7, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (4800, MAXIMUM), 
COSTTIME- (0,196), 
COSTBYTE- (0,196) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT-120, 
CONGEST- (LOW, HIGH), 
ROUTERES- (0,223) 
LINEROW WEIGHT=240, 
NUMBER-8, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY (MINIMUM, MAXIMUM), 
COSTTIME- (0,255), 
COSTBYTE- (0,255) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY=(UNSECURE , MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT-160, 
CONGEST= (LOW, HIGH), 
ROUTERES=(0,255) 


* 


SNASVCMG APPNCOS PRIORITY=NETWORK 
LINEROW WEIGHT=30, 
NUMBER-1, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
САРАСІТҮ= (4M, MAXIMUM) , 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY- (MINIMUM, NEGLIGIB), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=1, 
WEIGHT-5, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,31) 
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node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 


transmission priority 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 


*04150000 
*04200000 
*04250000 

04300000 
*04350000 
*04400000 
*04450000 
*04500000 
*04550000 
*04600000 
*04650000 
*04700000 
*04750000 

04800000 
*04850000 
*04900000 
*04950000 

05000000 
*05050000 
*05100000 
*05150000 
*05200000 
*05250000 
*05300000 
*05350000 
*05400000 
*05450000 

05500000 
*05550000 
*05600000 
*05650000 

05700000 

05750000 

05800000 
*05900000 
*05950000 
*06000000 
*06050000 
*06100000 
*06150000 
*06200000 
*06250000 
*06300000 

06350000 
*06400000 
*06450000 
*06500000 

06550000 


LINEROW WEIGHT=60, 


NUMBER=2, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,0), 

COSTBYTE- (0,0) , 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY= (UNSECURE , MAXIMUM) 


NODEROW NUMBER=2, 


WEIGHT-10, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,63) 


LINEROW WEIGHT=90, 


NUMBER-3, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY= (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=3, 


WEIGHT-20, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,95) 


LINEROW WEIGHT=120, 


NUMBER-4, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
СОЅТТІМЕ= (0,0), 

СОЅТВҮТЕ= (0,0), 

PDELAY= (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=4, 


WEIGHT-40, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 127) 


LINEROW WEIGHT=150, 


NUMBER-5, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0) , 

PDELAY- (MINIMUM, PACKET) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=5, 


WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,159) 


line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

ROUTE ADDITION RESISTANC 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitte 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitte 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 


*06600000 
*06650000 
*06700000 
*06750000 
*06800000 
*06850000 
*06900000 
*06950000 
*07000000 

07050000 
*07100000 
*07150000 
*07200000 

07250000 
*07300000 
*07350000 
*07400000 
*07450000 
*07500000 
*07550000 
*07600000 
*07650000 
*07700000 

07750000 
*07800000 
*07850000 
*07900000 

07950000 
*08000000 
*08050000 
*08100000 
*08150000 
*08200000 
*08250000 
*08300000 
*08350000 
*08400000 

08450000 
*08500000 
*08550000 
*08600000 

08650000 
*08700000 
*08750000 
*08800000 
*08850000 
*08900000 
*08950000 
*09000000 
*09050000 
*09100000 

09150000 
*09200000 
*09250000 
*09300000 

09350000 
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LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM), 
СОЅТТІМЕ= (0,128), 
COSTBYTE- (0,128), 
PDELAY= (MINIMUM, PACKET) , 
SECURITY=(UNSECURE , MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 
LINEROW WEIGHT=210, 
NUMBER=7 , 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (4800, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT-120, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,223) 
LINEROW WEIGHT=240, 
NUMBER=8, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY (MINIMUM, MAXIMUM), 
COSTTIME- (0,255), 
COSTBYTE- (0,255) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY= (UNSECURE , MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT=160, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,255) 


* 


#CONNECT APPNCOS PRIORITY=MEDIUM 
LINEROW WEIGHT=30, 

NUMBER=1, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
САРАСІТҮ= (4M, MAXIMUM) , 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY- (MINIMUM, NEGLIGIB), 
SECURITY=(UNSECURE , MAXIMUM) 
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line 
line 
user 
user 
user 
LINE 


row weight 

row number 

defined char 1 
defined char 2 
defined char 3 
SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitte 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitte 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


transmission priority 
line row weight 

line row number 

user defined char 1 
user defined char 2 
user defined char 3 
line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


*09400000 
*09450000 
*09500000 
*09550000 
*09600000 
*09650000 
*09700000 
*09750000 
*09800000 

09850000 
*09900000 
*09950000 
*10000000 

10050000 
*10100000 
*10150000 
*10200000 
*10250000 
*10300000 
*10350000 
*10400000 
*10450000 
*10500000 

10550000 
*10600000 
*10650000 
*10700000 

10750000 
*10800000 
*10850000 
*10900000 
*10950000 
*11000000 
*11050000 
*11100000 
*11150000 
*11200000 

11250000 
*11300000 
*11350000 
*11400000 

11450000 

11500000 

11550000 
*11650000 
*11700000 
*11750000 
*11800000 
*11850000 
*11900000 
*11950000 
*12000000 
*12050000 

12100000 


NODEROW NUMBER=1, 


WEIGHT-5, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,31) 


LINEROW WEIGHT=60, 


NUMBER=2, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=2, 


WEIGHT-10, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,63) 


LINEROW WEIGHT=90, 


NUMBER-3, 

UPARM1= (0,255), 
UPARM2=(0,255) , 

UPARM3- (0,255) , 

CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=3, 


WEIGHT-20, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,95) 


LINEROW WEIGHT=120, 


NUMBER=4, 
UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255), 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=4, 


WEIGHT-40, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 127) 


LINEROW WEIGHT=150, 


NUMBER=5, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, PACKET) , 
SECURITY» (UNSECURE , MAXIMUM) 


node row number 

node row weight 
congestion 

route addition resistanc 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


*12150000 
*12200000 
*12250000 

12300000 
*12350000 
*12400000 
*12450000 
*12500000 
*12550000 
*12600000 
*12650000 
*12700000 
*12750000 

12800000 
*12850000 
*12900000 
*12950000 

13000000 
*13050000 
*13100000 
*13150000 
*13200000 
*13250000 
*13300000 
*13350000 
*13400000 
*13450000 

13500000 
*13550000 
*13600000 
*13650000 

13700000 
*13750000 
*13800000 
*13850000 
*13900000 
*13950000 
*14000000 
*14050000 
*14100000 
*14150000 

14200000 
*14250000 
*14300000 
*14350000 

14400000 
*14450000 
*14500000 
*14550000 
*14600000 
*14650000 
*14700000 
*14750000 
*14800000 
*14850000 

14900000 
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NODEROW NUMBER=5, 
WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,159) 
LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255), 
CAPACITY» (9600, MAXIMUM), 
COSTTIME- (0,128), 
COSTBYTE- (0,128), 
PDELAY= (MINIMUM, PACKET) , 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,191) 
LINEROW WEIGHT=210, 
NUMBER=7 , 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (4800, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT-120, 
CONGEST= (LOW, HIGH) , 
ROUTERES- (0,223) 
LINEROW WEIGHT=240, 
NUMBER=8, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY= (MINIMUM, MAXIMUM), 
COSTTIME- (0,255), 
COSTBYTE- (0,255) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY= (UNSECURE , MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT-160, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,255) 


node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


*14950000 
*15000000 
*15050000 

15100000 
*15150000 
*15200000 
*15250000 
*15300000 
*15350000 
*15400000 
*15450000 
*15500000 
*15550000 

15600000 
*15650000 
*15700000 
*15750000 

15800000 
*15850000 
*15900000 
*15950000 
*16000000 
*16050000 
*16100000 
*16150000 
*16200000 
*16250000 

16300000 
*16350000 
*16400000 
*16450000 

16500000 
*16550000 
*16600000 
*16650000 
*16700000 
*16750000 
*16800000 
*16850000 
*16900000 
*16950000 

17000000 
*17050000 
*17100000 
*17150000 

17200000 

17250000 
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#INTER 


APPNCOS PRIORITY=HIGH 
LINEROW WEIGHT=30, 


NUMBER=1, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 
САРАСІТҮ= (4M, MAXIMUM) , 
СОЅТТІМЕ= (0,0), 

СОЅТВҮТЕ= (0,0), 

PDELAY= (MINIMUM, NEGLIGIB), 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=1, 


WEIGHT-5, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,31) 


LINEROW WEIGHT=60, 


NUMBER=2, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=2, 


WEIGHT-10, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,63) 


LINEROW WEIGHT=90, 


NUMBER-3, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255) , 

CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,128), 

COSTBYTE- (0,128), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY= (UNSECURE , MAXIMUM) 


NODEROW NUMBER=3, 


WEIGHT-20, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,95) 


LINEROW WEIGHT=120, 


NUMBER-4, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255) , 

САРАСІТҮ= (19200, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0), 

PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (UNSECURE , MAXIMUM) 


NODEROW NUMBER=4, 


WEIGHT-40, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 127) 


transmission priority 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


17300000 
*17400000 
*17450000 
*17500000 
*17550000 
*17600000 
*17650000 
*17700000 
*17750000 
*17800000 

17850000 
*17900000 
*17950000 
*18000000 

18050000 
*18100000 
*18150000 
*18200000 
*18250000 
*18300000 
*18350000 
*18400000 
*18450000 
*18500000 

18550000 
*18600000 
*18650000 
*18700000 

18750000 
*18800000 
*18850000 
*18900000 
*18950000 
*19000000 
*19050000 
*19100000 
*19150000 
*19200000 

19250000 
*19300000 
*19350000 
*19400000 

19450000 
*19500000 
*19550000 
*19600000 
*19650000 
*19700000 
*19750000 
*19800000 
*19850000 
*19900000 

19950000 
*20000000 
*20050000 
*20100000 

20150000 
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LINEROW WEIGHT=150, 
NUMBER=5, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,128), 
COSTBYTE- (0,128), 
PDELAY= (MINIMUM, PACKET) , 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=5, 
WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,159) 
LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
СОЅТТІМЕ= (0,0), 
COSTBYTE- (0,0) , 
PDELAY- (MINIMUM, PACKET) , 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 
LINEROW WEIGHT=210, 
NUMBER-7, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY= (UNSECURE , MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT=120, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,223) 


line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


*20200000 
*20250000 
*20300000 
*20350000 
*20400000 
*20450000 
*20500000 
*20550000 
*20600000 

20650000 
*20700000 
*20750000 
*20800000 

20850000 
*20900000 
*20950000 
*21000000 
*21050000 
*21100000 
*21150000 
*21200000 
*21250000 
*21300000 

21350000 
*21400000 
*21450000 
*21500000 

21550000 
*21600000 
*21650000 
*21700000 
*21750000 
*21800000 
*21850000 
*21900000 
*21950000 
*22000000 

22050000 
*22100000 
*22150000 
*22200000 

22250000 
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LINEROW WEIGHT=240, 
NUMBER=8, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY (MINIMUM, MAXIMUM), 
СОЅТТІМЕ= (0,255), 
СОЅТВҮТЕ= (0,255) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT-160, 
CONGEST- (LOW, HIGH), 
ROUTERES- (0,255) 
* 
#INTERSC APPNCOS PRIORITY=HIGH 
LINEROW WEIGHT=30, 
NUMBER=1, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3=(0,255) , 
CAPACITY=(4M,MAXIMUM) , 
COSTTIME=(0,0), 
COSTBYTE=(0,0), 
PDELAY= (MINIMUM, NEGLIGIB), 
SECURITY» (PUBLIC,MAXIMUM) 
NODEROW NUMBER=1, 
WEIGHT-5, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,31) 
LINEROW WEIGHT=60, 
NUMBER=2, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (56000, MAXIMUM), 
СОЅТТІМЕ= (0,0), 
СОЅТВҮТЕ= (0,0), 
PDELAY= (MINIMUM, TERRESTR) , 
SECURITY= (PUBLIC,MAXIMUM) 
NODEROW NUMBER=2, 
WEIGHT=10, 
CONGEST= (LOW, LOW) , 
ROUTERES= (0,63) 
LINEROW WEIGHT=90, 
NUMBER=3, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,128), 
COSTBYTE- (0,128), 
PDELAY- (MINIMUM, TERRESTR) , 
SECURITY» (PUBLIC,MAXIMUM) 
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line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


transmission priority 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


*22300000 
*22350000 
*22400000 
*22450000 
*22500000 
*22550000 
*22600000 
*22650000 
*22700000 

22750000 
*22800000 
*22850000 
*22900000 

22950000 

23000000 

23050000 
*23150000 
*23200000 
*23250000 
*23300000 
*23350000 
*23400000 
*23450000 
*23500000 
*23550000 

23600000 
*23650000 
*23700000 
*23750000 

23800000 
*23850000 
*23900000 
*23950000 
*24000000 
*24050000 
*24100000 
*24150000 
*24200000 
*24250000 

24300000 
*24350000 
*24400000 
*24450000 

24500000 
*24550000 
*24600000 
*24650000 
*24700000 
*24750000 
*24800000 
*24850000 
*24900000 
*24950000 

25000000 
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NODEROW NUMBER=3, 
WEIGHT-20, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,95) 
LINEROW WEIGHT=120, 
NUMBER=4, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3- (0,255) , 
CAPACITY» (19200, MAXIMUM) , 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY= (MINIMUM, TERRESTR) , 
SECURITY= (PUBLIC,MAXIMUM) 
NODEROW NUMBER=4, 
WEIGHT-40, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,127) 
LINEROW WEIGHT=150, 
NUMBER-5, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3= (0,255) , 
САРАСІТҮ= (19200, MAXIMUM) , 
COSTTIME- (0,128), 
COSTBYTE- (0,128), 
PDELAY= (MINIMUM, PACKET) , 
SECURITY» (PUBLIC,MAXIMUM) 
NODEROW NUMBER=5, 
WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,159) 
LINEROW WEIGHT=180, 
NUMBER-6, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM), 
СОЅТТІМЕ= (0,0), 
СОЅТВҮТЕ= (0,0), 
PDELAY= (MINIMUM, PACKET) , 
SECURITY= (PUBLIC,MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 


node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


*25050000 
*25100000 
*25150000 

25200000 
*25250000 
*25300000 
*25350000 
*25400000 
*25450000 
*25500000 
*25550000 
*25600000 
*25650000 

25700000 
*25750000 
*25800000 
*25850000 

25900000 
*25950000 
*26000000 
*26050000 
*26100000 
*26150000 
*26200000 
*26250000 
*26300000 
*26350000 

26400000 
*26450000 
*26500000 
*26550000 

26600000 
*26650000 
*26700000 
*26750000 
*26800000 
*26850000 
*26900000 
*26950000 
*27000000 
*27050000 

27100000 
*27150000 
*27200000 
*27250000 

27300000 
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* 


TBATCH 


LINEROW WEIGHT=210, 
NUMBER=7, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 


CAPACITY» (9600, MAXIMUM), 
COSTTIME- (0,196), 
COSTBYTE- (0,196), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (PUBLIC,MAXIMUM) 


NODEROW NUMBER=7, 
WEIGHT-120, 


CONGEST= (LOW, HIGH), 
ROUTERES=(0,223) 


LINEROW WEIGHT=240, 
NUMBER=8, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 


CAPACITY-(MINIMUM,MAXIMUM), line speed 
С05ТТІМЕ-(0,255), 
С05ТВҮТЕ-(0,255), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (PUBLIC,MAXIMUM) 


NODEROW NUMBER=8, 
WEIGHT-160, 


CONGEST= (LOW, HIGH), 
ROUTERES=(0,255) 


APPNCOS PRIORITY=LOW 

LINEROW WEIGHT=30, 
NUMBER=1, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 


САРАСІТҮ= (56000, MAXIMUM), line speed 


COSTTIME- (0,0), 
COSTBYTE- (0,0), 


PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (UNSECURE , MAXIMUM) 


NODEROW NUMBER=1, 
WEIGHT-5, 


CONGEST= (LOW, LOW) , 


ROUTERES- (0,31) 
LINEROW WEIGHT=60, 
NUMBER=2, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 


САРАСІТҮ= (19200, MAXIMUM), line speed 


COSTTIME- (0,0), 
COSTBYTE- (0,0), 


PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (UNSECURE , MAXIMUM) 


line row weight *27350000 
line row number *27400000 
user defined char 1 *27450000 
user defined char 2 *27500000 
user defined char 3 *27550000 
LINE SPEED *27600000 
cost per connect time *27650000 


cost per byte transmitted *27700000 


propagation delay *27750000 
security level for TG 27800000 
node row number *27850000 
node row weight *27900000 
congestion *27950000 
route addition resistance 28000000 
line row weight *28050000 
line row number *28100000 
user defined char 1 *28150000 
user defined char 2 *28200000 
user defined char 3 *28250000 

*28300000 
cost per connect time *28350000 


cost per byte transmitted  *28400000 


propagation delay *28450000 
security level for TG 28500000 
node row number *28550000 
node row weight *28600000 
congestion *28669990 
route addition resistance 28700000 

28750000 
transmission priority 28800000 
line row weight *28900000 
line row number *28950000 
user defined char 1 *29000000 
user defined char 2 *29050000 
user defined char 3 *29100000 

*29150000 
cost per connect time *29200000 


cost per byte transmitted *29250000 


propagation delay *29300000 
security level for TG 29350000 
node row number *29400000 
node row weight *29450000 
congestion *29500000 
route addition resistance 29550000 
line row weight *29600000 
Tine row number *29650000 
user defined char 1 *29700000 
user defined char 2 *29750000 
user defined char 3 *29800000 

*29850000 
cost per connect time *29900000 


cost per byte transmitted *29950000 
propagation delay *30000000 
security level for TG 30050000 
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NODEROW NUMBER=2, 
WEIGHT=10, 
CONGEST=(LOW, LOW) , 
ROUTERES= (0,63) 

LINEROW WEIGHT=90, 

NUMBER=3, 

UPARM1= (0,255), 

UPARM2= (0,255) , 

UPARM3- (0,255), 

CAPACITY» (19200, MAXIMUM), 
COSTTIME- (0,128), 

COSTBYTE- (0,128) , 

PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (UNSECURE , MAXIMUM) 

NODEROW NUMBER=3, 

WEIGHT=20, 
CONGEST= (LOW, LOW) , 
ROUTERES=(0,95) 

LINEROW WEIGHT=120, 

NUMBER=4, 

UPARM1= (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,0), 

COSTBYTE- (0,0) , 

PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (UNSECURE , MAXIMUM) 

NODEROW NUMBER=4, 

WEIGHT=40, 
CONGEST=(LOW, LOW) , 
ROUTERES- (0, 127) 

LINEROW WEIGHT=150, 

NUMBER-5, 

UPARMI- (0,255), 

UPARM2- (0,255) , 

UPARM3- (0,255), 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,128), 

COSTBYTE- (0,128) , 

PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (UNSECURE , MAXIMUM) 

NODEROW NUMBER=5, 

WEIGHT=60, 
CONGEST=(LOW, LOW) , 
ROUTERES=(0, 159) 


node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

ROUTE ADDITION RESISTANCE 


*30100000 
*30150000 
*30200000 

30250000 
*30300000 
*30350000 
*30400000 
*30450000 
*30500000 
*30550000 
*30600000 
*30650000 
*30700000 

30750000 
*30800000 
*30850000 
*30900000 

30950000 
*31000000 
*31050000 
*31100000 
*31150000 
*31200000 
*31250000 
*31300000 
*31350000 
*31400000 

31450000 
*31500000 
*31550000 
*31600000 

31650000 
*31700000 
*31750000 
*31800000 
*31850000 
*31900000 
*31950000 
*32000000 
*32050000 
*32100000 

32150000 
*32200000 
*32250000 
*32300000 

32350000 
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LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 
LINEROW WEIGHT=210, 
NUMBER-7, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (4800, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT-120, 
CONGEST= (LOW, HIGH) , 
ROUTERES- (0,223) 
LINEROW WEIGHT=240, 
NUMBER-8, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3=(0,255) , 
CAPACITY=(MINIMUM,MAXIMUM) , 
С05ТТІМЕ-(0,255), 
С05ТВҮТЕ-(0,255), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (UNSECURE , MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT=160, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,255) 


* 


#BATCHSC APPNCOS PRIORITY=LOW 

LINEROW WEIGHT=30, 
NUMBER=1, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (56000, MAXIMUM), 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (PUBLIC,MAXIMUM) 

NODEROW NUMBER=1, 
WEIGHT-5, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,31) 


Appendix B. Client/Server Environment Used 


line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


transmission priority 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


*32400000 
*32450000 
*32500000 
*32550000 
*32600000 
*32650000 
*32700000 
*32750000 
*32800000 

32850000 
*32900000 
*32950000 
*33000000 

33050000 
*33100000 
*33150000 
*33200000 
*33250000 
*33300000 
*33350000 
*33400000 
*33450000 
*33500000 

33550000 
*33600000 
*33650000 
*33700000 

33750000 
*33800000 
*33850000 
*33900000 
*33950000 
*34000000 
*34050000 
*34100000 
*34150000 
*34200000 

34250000 
*34300000 
*34350000 
*34400000 

34450000 

34500000 

34550000 
*34650000 
*34700000 
*34750000 
*34800000 
*34850000 
*34900000 
*34950000 
*35000000 
*35050000 

35100000 
*35150000 
*35200000 
*35250000 

35300000 
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LINEROW WEIGHT=60, 
NUMBER=2, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (19200, MAXIMUM), 
COSTTIME- (0,0), 
COSTBYTE- (0,0) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (PUBLIC, MAXIMUM) 
NODEROW NUMBER=2, 
WEIGHT=10, 
CONGEST=(LOW, LOW) , 
ROUTERES- (0,63) 
LINEROW WEIGHT=90, 
NUMBER=3, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255), 
CAPACITY» (19200, MAXIMUM), 
COSTTIME- (0,128), 
СОЅТВҮТЕ= (0,128) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (PUBLIC, MAXIMUM) 
NODEROW NUMBER=3, 
WEIGHT=20, 
CONGEST=(LOW, LOW) , 
ROUTERES- (0,95) 
LINEROW WEIGHT=120, 
NUMBER=4, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255), 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,0), 
COSTBYTE- (0,0), 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (PUBLIC, MAXIMUM) 
NODEROW NUMBER=4, 
WEIGHT=40, 
CONGEST= (LOW, LOW) , 
ROUTERES=(0,127) 
LINEROW WEIGHT=150, 
NUMBER=5, 
UPARM1= (0,255), 
UPARM2= (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM) , 
COSTTIME- (0,128), 
COSTBYTE- (0,128) , 
PDELAY= (MINIMUM, MAXIMUM) , 
SECURITY» (PUBLIC,MAXIMUM) 


line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 


*35350000 
*35400000 
*35450000 
*35500000 
*35550000 
*35600000 
*35650000 
*35700000 
*35750000 

35800000 
*35850000 
*35900000 
*35950000 

36000000 
*36050000 
*36100000 
*36150000 
*36200000 
*36250000 
*36300000 
*36350000 
*36400000 
*36450000 

36500000 
*36550000 
*36600000 
*36650000 

36700000 
*36750000 
*36800000 
*36850000 
*36900000 
*36950000 
*37000000 
*37050000 
*37100000 
*37150000 

37200000 
*37250000 
*37300000 
*37350000 

37400000 
*37450000 
*37500000 
*37550000 
*37600000 
*37650000 
*37700000 
*37750000 
*37800000 
*37850000 

37900000 


NODEROW NUMBER=5, 
WEIGHT-60, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0,159) 
LINEROW WEIGHT=180, 
NUMBER=6, 
UPARM1= (0,255), 
UPARM2=(0,255) , 
UPARM3- (0,255) , 
CAPACITY» (9600, MAXIMUM), 
COSTTIME- (0,196), 
COSTBYTE- (0,196), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (PUBLIC,MAXIMUM) 
NODEROW NUMBER=6, 
WEIGHT-80, 
CONGEST= (LOW, LOW) , 
ROUTERES- (0, 191) 
LINEROW WEIGHT=210, 
NUMBER=7 , 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY» (4800, MAXIMUM) , 
COSTTIME- (0,196), 
COSTBYTE- (0,196), 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY= (PUBLIC,MAXIMUM) 
NODEROW NUMBER=7, 
WEIGHT-120, 
CONGEST= (LOW, HIGH) , 
ROUTERES- (0,223) 
LINEROW WEIGHT=240, 
NUMBER-8, 
UPARM1= (0,255), 
UPARM2- (0,255) , 
UPARM3- (0,255) , 
CAPACITY (MINIMUM, MAXIMUM), 
COSTTIME- (0,255), 
COSTBYTE- (0,255) , 
PDELAY= (MINIMUM, MAXIMUM), 
SECURITY» (PUBLIC,MAXIMUM) 
NODEROW NUMBER=8, 
WEIGHT-160, 
CONGEST= (LOW, HIGH), 
ROUTERES- (0,255) 


node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

LINE SPEED 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 
line row weight 

line row number 

user defined char 1 

user defined char 2 

user defined char 3 

line speed 

cost per connect time 
cost per byte transmitted 
propagation delay 
security level for TG 
node row number 

node row weight 
congestion 

route addition resistance 


*37950000 
*38000000 
*38050000 

38100000 
*38150000 
*38200000 
*38250000 
*38300000 
*38350000 
*38400000 
*38450000 
*38500000 
*38550000 

38600000 
*38650000 
*38700000 
*38750000 

38800000 
*38850000 
*38900000 
*38950000 
*39000000 
*39050000 
*39100000 
*39150000 
*39200000 
*39250000 

39300000 
*39350000 
*39400000 
*39450000 

39500000 
*39550000 
*39600000 
*39650000 
*39700000 
*39750000 
*39800000 
*39850000 
*39900000 
*39950000 

40000000 
*40050000 
*40100000 
*40150000 

40200000 
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3. 


IPINCP VTAMLST 


NCPOPT OPTIONS NEWDEFN=(YES,ECHO,SUPP,REUSE) 
* STATOPT=’ NCP TR 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


* NCP FUER 3745 MOD NCP VERS5 REL4 * 
M ag asset fk ol Ti ic йай ek de Ki Et rd Б ek ei ae ms ама A dE pk idi idu ed pa nad eae a E * 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
* * 
* HISTORY: ж 
ж ж 
* VERSION AENDERUNG DATUM МАМЕ * 
* IPINCP ERHOEHUNG HSCB UND GWNAU 20.10.94 HOLZE * 
* IPISVOO — NEUGENERIERUNG 07.03.94 HOLZE * 
* * 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


IPIPCCU PCCU CUADDR-520, 
NETID=DEIBMIP1, GAIN-NETZ 
SUBAREA=10, X'01' COMNET HOST 
OWNER=IP1, X'01' COMNET HOST 
BACKUP-NO, 


AUTODMP-NO, 
DUMPDS-VTAMDUMP , 
MAXDATA-6173, 
VFYLM-YES 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
BUILD MODEL=3745, 
VERSION=V7R4, 


+ жж ok FF ж 


MEMSIZE-4M, ***** EINGEF. WG. BUFFERCALCULATION *****C 


NETID=DEIBMIP1, SUBNETZ COMNET IST NAITIVE NETWORK 
USGTIER=3, 

TYPGEN=NCP, 

BRANCH=1000, 

ERLIMIT=16, 

SALIMIT=511, 

SUBAREA=35, NO OF THIS NCP NODE X'OD^ 
NEWNAME-IPINCP, 

PUNAME-IPINCP, 

LOADLIB=IP1NCP, NAME OF DD-STMT IN SYS1.PROCLIB 
ENABLTO=180, TIME OUT FOR SWITCHED DS 
DSABLTO=10, 

BFRS=240, | SIZE ОҒ NCP BUFFERS 

DYNPOOL- (5,1) , 

TRANSFR-26, 

NAMTAB-1000, 

HSBPOOL=400, 

COSTAB=ISTSDCOS, 


VRPOOL- (400,0) , V4R3 
LOCALTO=2.0, V4R3 
REMOTTO=3.0, V4R3 
PATHEXT=0, V4R3 
TGBXTRA=0, V4R3 
MAXSSCP=8, MAX NO OF SSCPS, NCP CAN BE IN SESS CONCURR 
OLT=YES, INCLUDE THE ONLINE TERMINAL/LINE TEST 


SLODOWN=12, MIN NO OF BUFF IN PERC.BEFORE SLODOWN 
CWALL=50, 
TRACE=(YES,50) CHAN ADAPTER TRACE (OVERHEAD?) 
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C3 C) еу СЭ Сэ ССЭ C CACEN СЭУ OO 050 CS CY 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


SYSCNTRL OPTIONS=(ENDCALL,MODE ,RCNTRL,RCOND ,RECMD , BHSASSC , RIMMC 
,NAKLIM, SESSION, SSPAUSE, STORDSP , XMTLMT , BACKUP, DVSINIT , LNC 
STAT, SESINIT) 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


GWNAU NUMADDR=200 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
IP1 HOST INBFRS=6, OUTBOUND 6 * 120 BFRS С 

NETID=DEIBMIP1, C 
MAXBFRU=25, МО VTAM BUFFERS FOR 1 510 MAX. 20 * UNITSZC 
SUBAREA-10, EQUAL SUBAREA OF PCCU AND EQUAL HOSTSA C 
UNITSZ-256, | MUST EQUAL TO IOBUF(BUFSIZE) OF START PAR C 
BFRPAD-0 BUFFER PAD (MANDATORY FOR ACF) 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


kkkkk LUDRPOOL kkkkk 
kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
IPIPUDR PUDRPOOL NUMBER-10 

IPILUDR LUDRPOOL NUMTYP2-100, C 

NUMILU-10 

kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
* TOKEN - RING * 
* DEFINITIONEN * 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 
* 


IP1TRGP1 GROUP ECLTYPE-(PHYSICAL, ANY) , ISTATUS=ACTIVE, EIK 
ADAPTER-TIC2,MAXTSL-6173, RCVBUFC=6173, TRSPEED=16, 
TYPE=NCP, 
DIAL=NO, 
LNCTL=SDLC, 
LEVEL2=ECLNARL2, 
LEVEL3=ECLNARL3, 
LEVEL5-NCP, 
TIMER=(ECLNART1, , ECLNART2, ECLNART3) , 
X107 (ECLNARXL , ECLNARXS , ECLNARXI , ECLNARXK) , 
USERID- (5668854, ECLRBDT , NORECMS, , ECLNMVT) , 
MAXPU-1, 
SPEED-9600, 
PUTYPE-1, 
PUDR-NO, 
COMPTAD-YES, 
COMPSWP=YES, 
COMPOWN=YES 

% 5ТАТОРТ-0МІТ 

IPITRL1 LINE ADDRESS=(1088, FULL) , PORTADD=1, LOCADD=400023700601, С 
XMONLNK=YES, C 
UACB- (X$P1AX, X$P1AR) 

IPITRPU1 PU ISTATUS-ACTIVE, C 
ADDR-01, 
INNPORT-YES, C 
ANS-CONTINUE 


COO же ЗЫ €): OF. C) OO. CO) C». C». C3 C» 000960 


O 


* 


IP1TRGL1 GROUP ECLTYPE=(LOGICAL, SUBAREA) ,NETID=DEIBM159, 
SDLCST- (TRN16P, TRN16S) ,MONLINK=YES, 
PUTYPE=4 ,MAXOUT=127 ,MODULO=128, 
PHYPORT=1, 

TYPE=NCP, 

DIAL=NO, 

LNCTL=SDLC, 

LEVEL2=ECLNAVL2, 

LEVEL3=ECLNAVL3, 

LEVEL5-NCP, 

X107 (ECLNAVXL, ECLNAVXS , ECLNAVXI , ECLNAVXK) , 


сэс жу ы "р ДЕ чє су м ДЫ C C00) CX 
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USERID- (5668854, ECLVBDT , NORECMS, , ECLNMVT) , 
LINEADD=NONE, 
MAXPU=1, 
COMPOWN-YES, 
RETRIES- (6,0,0,6) 
* 5ТАТОРТ-0МІТ 
IP141F36 LINE UACB=X$L1A 
IP151F36 PU TGN=1,ADDR=04400010000248 
* 


65.0 


kkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkkk 


* STANDARD NTRI GROUP, LOGICAL EIK 
ХА k K k k K k k k k k k k K k k k k k k k K АСА k k k k k k k Е I Krakk 
IPITRGL9 GROUP AUTOGEN=050,ECLTYPE=LOGICAL,PHYPORT=1,ANS=CONT, EIK 
LNCTL=SDLC,DIAL=YES,CALL=INOUT, DOM 
NPACOLL=NO, I STATUS=ACTIVE, EIK 
TYPE=NCP, 

LEVEL2=ECLNAVL2, 

LEVEL3=ECLNAVL3, 

LEVEL5-NCP, 

X107 (ECLNAVXL, ECLNAVXS , ECLNAVXI , ECLNAVXK) , 

USERID- (5668854, ECLVBDT , NORECMS, , ECLNMVT) , 

LINEADD=NONE, 

LINEAUT=YES, 
PUTYPE=2, 
XMITDLY=NONE, 

COMPOWN=YES, 
RETRIES=(6,0,0,6) 
IGNORE * LINES BETWEEN IGNORE/NOIGNORE WILL BE REGENERATED 


00.05 CO Ж че: ШЇ C) 0-03 €) CO) (УСУ 
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4. IPISW10 VTAMLST 


- 


ж 


IP1MSW10 VBUILD TYPE=SWNET, 


* 


IP1P10 PU 


IP1T1002 LU 
IP1T1003 LU 
IP1T1004 LU 
* 


IP1P11 PU 


IP1T1102 LU 
IP1T1103 LU 
IP1T1104 LU 
* 


IP1P12 PU 


IP1T1202 LU 
IP1T1203 LU 
IP1T1204 LU 
* 


MAXGRP=5, 
MAXNO=40 


ADDR=01, 
DISCNT=NO, 
CPNAME=IP1P10CP, 
DYNLU=YES, 
MAXDATA=1920, 
MODETAB=MTD1SERH, 
DLOGMOD=QUERY, 
VPACING=0, 
PUTYPE=2, 
ANS=CONT, 
CONNTYPE=APPN, 
USSTAB=USSTERM 
LOCADDR=02 
LOCADDR=03 
LOCADDR=04 


ADDR=02, 
DISCNT=NO, 
CPNAME=IP1P11CP, 
DYNLU=YES, 
MAXDATA=1920, 
MODETAB=MTD1SERH, 
DLOGMOD=QUERY, 
VPACING=0, 
PUTYPE=2, 
ANS=CONT, 
CONNTYPE=APPN, 
USSTAB=USSTERM 
LOCADDR=02 
LOCADDR=03 
LOCADDR=04 


ADDR=03, 
DISCNT=NO, 
CPNAME=IP1P12CP, 
DYNLU=YES, 
MAXDATA-1920, 
MODETAB=MTD1SERH, 
DLOGMOD=QUERY, 
VPACING=0, 
PUTYPE=2, 
ANS=CONT, 
CONNTYPE=APPN, 
USSTAB=USSTERM 
LOCADDR=02 
LOCADDR=03 
LOCADDR=04 


EIN 
C 
NUMBER OF UNIQUE PATH GROUPS C 
NUMBER OF UNIQUE PHONE NUMBERS 
COULD BE ANYTHING (NOT USED) C 
C 
C 
C 
MAXDATE 0S/2 CM (0LD:1033 2/12/92) C 
C 
C 
C 
C 
C 
ALLOWS APPN OR LEN C 
COULD BE ANYTHING (NOT USED) C 
C 
C 
C 
MAXDATE 0S/2 CM (0LD:1033 2/12/92) C 
C 
C 
C 
C 
C 
ALLOWS APPN OR LEN C 
COULD BE ANYTHING (NOT USED) C 
C 
C 
C 
MAXDATE 0S/2 CM (0LD:1033 2/12/92) C 
C 
C 
C 
C 
C 
ALLOWS APPN OR LEN C 
cont ...... 
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PE cont 
IP1P13 PU ADDR=04, COULD BE ANYTHING (NOT USED) 
DISCNT=NO, 
CPNAME=IP1P13CP, 
DYNLU=YES, 
MAXDATA=1920, MAXDATE 0S/2 CM (0LD:1033 2/12/92) 


MODETAB=MTD1SERH, 
DLOGMOD=QUERY, 
VPACING=0, 
PUTYPE=2, 
ANS=CONT, 
CONNTYPE=APPN, ALLOWS APPN OR LEN 
USSTAB=USSTERM 
IP1T1302 LU LOCADDR=02 
IP1T1303 LU LOCADDR=03 
IP1T1304 LU LOCADDR=04 


* 


OOOO Ж чес Су OS Су СУ 


5. IP1ITSO VTAMLST 


- 


VBUILD TYPE=CDRSC 
DEIBMIP1 NETWORK NETID=DEIBMIP1 
* 
IP1P13CO CDRSC ALSLIST=(IP1P13CP,1P1P13) ,RESSCB=12, 
ALSREQ=YES , DLOGMOD= I BMRDB 
ІРІРІЗСІ CDRSC ALSLIST=(IP1P13CP,1P1P13) ,RESSCB=12, 
ALSREQ=YES , DLOGMOD= I BMRDB 


* 
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B.3.1.2 VTAM Definitions for VSE 


1. ATCSTROO.B 


2. 


3. 


4. 


- 


SSCPID=122, 
HOSTSA=122, 
SSCPNAME=IP1VM, 
HOSTPU-IPIMPU, 
NOPROMPT, 
NETID=DEIBMIP1, 
MAXSUBA=255, 
CONFIG=00, 
IOINT=0, 
SGALIMIT=0, 

BSBUF- (28,,,,1), 
CRPLBUF* (60,,,,1), 
LFBUF=(70,,,,11), 
IOBUF=(70,288,,,11), 
LPBUF=(12,,,,6), 
SFBUF=(20,,,,20), 
SPBUF-(210,,,,32), 
XDBUF=(6,,,51) 

/+ 


IP1JM.B 


CY 0:£ 06:00:00 СУ Сус СУС 03-05 


VTMADJS VBUILD TYPE-ADJSSCP 
DEIBMIP1 NETWORK NETID=DEIBMIP1 
IP1 ADJCDRM 

/+ 


IP1KMIP1.B 


- 


ҮТМСТСА VBUILD ТҮРЕ-СА 


ISTATUS=ACTIVE 
IP1LC21 LINE ADDRESS=C22 
IP1PC21 PU PUTYPE=4 
/+ 


IP1GC21 GROUP LNCTL=CTCA,MAXBFRU=2, 


IP1WM.B 


- 


VTMCDRM VBUILD TYPE=CDRM 
DEIBMIP NETWORK NETID=DEIBMIP1 


/+ 


IP1 CDRM SUBAREA=10,CDRDYN=YES,CDRSC=OPT 
IP2 CDRM SUBAREA=20,CDRDYN=YES,CDRSC=OPT 
IP1VM CDRM | SUBAREA-122, CDRDYN-YES , CDRSC-OPT 
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B.4 OS/2 Definitions 


The following are the definitions we used in our OS/2 stations. 


B.4.1 APPN10.NDF (Communication Server Definition) 


DEFINE LOCAL СР FQ СР NAME(DEIBMIP1.IP1P10CP) 


CP ALIAS(IP1P10CP) 

NAU ADDRESS (INDEPENDENT LU) 
NODE TYPE(EN) 

NODE 1D(X'05D00000') 

NW FP SUPPORT (NONE) 

HOST FP SUPPORT (YES) 

DLUR MULTISUBNET SUPPORT(YES) 
FREE UNUSED SESSIONS (NO) 

FREE UNUSED SESSIONS TIME(10) 
HOST FP LINK NAME(LINK0001) 
MAX COMP LEVEL(NONE) 

МАХ СОМР TOKENS (0) ; 


DEFINE LOGICAL LINK LINK NAME(LINK0001) 


ADJACENT NODE TYPE(NN) 
PREFERRED NN SERVER(YES) 

DLC NAME (IBMTRNET) 

ADAPTER NUMBER (0) 
DESTINATION ADDRESS (X’40002370060104’) 
ETHERNET FORMAT (NO) 

CP CP SESSION SUPPORT(YES) 
SOLICIT SSCP SESSION(YES) 

NODE 1D(X'05D00000') 

USE PUNAME AS СРМАМЕ (NO) 

MAX ACTIVATION ATTEMPTS(USE ADAPTER DEFINITION) 
AUTO REACTIVATE(NO RETRY) 
ACTIVATE AT STARTUP(YES) 

LIMITED RESOURCE (NO) 

LINK STATION ROLE(USE ADAPTER DEFINITION) 
EFFECTIVE CAPACITY(USE ADAPTER DEFINITION) 
COST PER CONNECT TIME(USE ADAPTER DEFINITION) 
COST PER BYTE(USE ADAPTER DEFINITION) 
SECURITY(USE ADAPTER DEFINITION) 
PROPAGATION DELAY(USE ADAPTER DEFINITION) 

HPR SUPPORT (NO) 

LIMITED RESOURCE TIMEOUT(USE ADAPTER DEFINITION) 
INACTIVITY TIMEOUT(USE ADAPTER DEFINITION) 
USER DEFINED 1(USE ADAPTER DEFINITION) 

USER DEFINED 2(USE ADAPTER DEFINITION) 

USER DEFINED 3(USE ADAPTER DEFINITION); 


DEFINE LUA 


LU NAME (@LUA0001) 
HOST LINK NAME(LINK0001) 
МАУ ADDRESS (2) ; 
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DEFINE PARTNER LU 


DEFINE PARTNER LU 


FQ PARTNER LU NAME (DEIBMIP1.IP1AITSO) 
DESCRIPTION(DB2 VM) 
PARTNER LU ALIAS (SRVVMO1) 

PARTNER LU UNINTERPRETED NAME (IP1AITSO) 
MAX MC LL SEND SIZE(32767) 

CONV SECURITY VERIFICATION(NO) 

DEFAULT ROUTING PREFERENCE (NATIVE FIRST) 
PARALLEL SESSION SUPPORT (YES) ; 


FQ PARTNER LU NAME (DEIBMIP1.IP1AMC ) 
DESCRIPTION(DB2 VSE) 
PARTNER LU ALIAS(SRVSEO1) 

PARTNER LU UNINTERPRETED NAME(IP1AMC ) 
MAX MC LL SEND SIZE(32767) 

CONV SECURITY VERIFICATION(NO) 

DEFAULT ROUTING PREFERENCE(NATIVE FIRST) 
PARALLEL SESSION SUPPORT(YES); 


DEFINE MODE MODE 


| NAME(IBMRDB ) 
COS | 


NAME (CONNECT) 


DEFAULT RU SIZE(YES) 


RECE 


MAX 
PLU | 
MIN 


PACI 
COMP 


PLU | 
SLU_ 


SESS 
APPN 


ТУЕ PACING WINDOW(4) 
NEGOTIABLE SESSION LIMIT(32767) 
MODE SESSION LIMIT(20) 
CONWINNERS SOURCE (10) 

NG TYPE (ADAPTIVE) 

RESSION NEED(PROHIBITED) 

SLU COMPRESSION(NONE) 

PLU COMPRESSION(NONE) 

ION LEVEL ENCRYPTION(NO) 


| ENCRYPTION SUPPORT (NO); 


DEFINE DEFAULTS 


IMPLICIT INBOUND PLU SUPPORT(YES) 
DEFAULT MODE NAME (BLANK) 

MAX MC LL SEND SIZE (32767) 
DIRECTORY FOR INBOUND ATTACHES(*) 
DEFAULT TP OPERATION(NONQUEUED AM STARTED) 
DEFAULT TP PROGRAM TYPE (BACKGROUND) 
DEFAULT TP CONV SECURITY RQD(NO) 

MAX HELD ALERTS(10) 

DEFAULT ROUTING PREFERENCE(NATIVE FIRST) 
IMPLICIT LINK HPR SUPPORT(YES) 

RETRY COUNT (6) 

ALIVE TIMER(60) 

PATH SWITCH TIMER LOW(480) 

PATH SWITCH TIMER MEDIUM(240) 

PATH SWITCH TIMER HIGH(120) 
TN3270E PORT (23) 

TN3270E KEEPALIVE TYPE(NONE) 

TN3270E AUTOMATIC LOGOFF (0) 

DISABLE DLUR REGISTRATION(NO); 
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DEFINE ТР SNA SERVICE ТР NAME(X/07/,6DB) 
PIP ALLOWED(NO) 
FILESPEC (UNUSED) 
CONVERSATION TYPE(ANY TYPE) 
CONV SECURITY RQD(NO) 
SYNC LEVEL(EITHER) 
TP OPERATION(QUEUED OPERATOR PRELOADED) 
PROGRAM TYPE (BACKGROUND) 
INCOMING ALLOCATE QUEUE DEPTH(255) 
INCOMING ALLOCATE TIMEOUT (INFINITE) 
RECEIVE ALLOCATE TIMEOUT ( INFINITE) ; 


DEFINE ТР SNA SERVICE ТР NAME(X/07/,6SN) 
PIP ALLOWED(NO) 
FILESPEC (UNUSED) 
CONVERSATION TYPE(ANY TYPE) 
CONV SECURITY RQD(NO) 
SYNC LEVEL(EITHER) 
TP OPERATION(QUEUED OPERATOR PRELOADED) 
PROGRAM TYPE(BACKGROUND) 
INCOMING ALLOCATE QUEUE DEPTH(255) 
INCOMING ALLOCATE TIMEOUT (INFINITE) 
RECEIVE ALLOCATE TIMEOUT ( INFINITE) ; 


DEFINE ТР TP NAME(BOEOS2) 
PIP ALLOWED(NO) 
FILESPEC(UNUSED) 
CONVERSATION TYPE(ANY TYPE) 
CONV. SECURITY RQD(NO) 
SYNC LEVEL(EITHER) 
TP OPERATION(QUEUED OPERATOR PRELOADED) 
PROGRAM TYPE(BACKGROUND) 
INCOMING ALLOCATE QUEUE DEPTH(255) 
INCOMING ALLOCATE TIMEOUT (INFINITE) 
RECEIVE ALLOCATE TIMEOUT (INFINITE); 


DEFINE ТР TP NAME(DB2INTERRUPT) 
PIP ALLOWED (NO) 
FILESPEC(UNUSED) 
CONVERSATION TYPE(ANY TYPE) 
CONV SECURITY RQD(NO) 
SYNC LEVEL(EITHER) 
TP OPERATION(QUEUED OPERATOR PRELOADED) 
PROGRAM TYPE(BACKGROUND) 
INCOMING ALLOCATE QUEUE DEPTH(255) 
INCOMING ALLOCATE TIMEOUT (INFINITE) 
RECEIVE ALLOCATE TIMEOUT (INFINITE); 


230 DB2 Server VM and VSE V5R1 


DEFINE CPIC SIDE INFO SYMBOLIC DESTINATION NAME (BOECTVM ) 
DESCRIPTION(SRVVMO1) 
PARTNER LU ALIAS(SRVVMOI ) 
MODE NAME(IBMRDB ) 
ТР NAME (SRVVMO1) ; 


DEFINE CPIC SIDE INFO SYMBOLIC DESTINATION NAME(BOECTVSE) 
DESCRIPTION(SRVSEO1) 
PARTNER LU ALIAS (SRVSEO1 ) 
MODE NAME(IBMRDB ) 
TP NAME(BOE1); 


START ATTACH MANAGER; 


B.4.2 DB2/2 OS/2 Database Definition 


1. Database Manager Configuration 


С”. aS 
Database Manager Configuration 
Node type = Database Server with local and remote clients 
Database manager configuration release level = 0х0600 
Maximum total of files open (MAXTOTFILOP) = 16000 
CPU speed (millisec/instruction) (CPUSPEED) = 1.962591e-05 
Max number of concurrently active databases (NUMDB) = 8 
Transaction processor monitor name (TP MON NAME) = 
Diagnostic error capture level (DIAGLEVEL) = 3 
Diagnostic data directory path (DIAGPATH) = 
Default database monitor switches 
Buffer pool (DFT MON BUFPOOL) = OFF 
Lock (DFT MON LOCK) = OFF 
Sort (DFT MON SORT) = OFF 
Statement (DFT MON STMT) = OFF 
Table (DFT MON TABLE) = OFF 
Unit of work (DFT MON UOW) = OFF 
cont ...... 
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Database monitor SQL statement size (bytes) (SQLSTMTSZ) 


SYSADM group name 

SYSCTRL group name 

SYSMAINT group name 

Database manager authentication 


Default database path 


Database monitor heap size (4KB) 
UDF shared memory set size (4KB) 


Backup buffer default size (4KB) 


Restore buffer default size (4KB) 


Agent stack size 


Minimum committed private memory (4KB) 


Private memory threshold (4KB) 
Sort heap threshold (4KB) 


Directory cache support 


Application support layer heap size (4KB) 
Max requester 1/0 block size (bytes) 
DOS requester I/0 block size (bytes) 


Query heap size (4KB) 
DRDA services heap size (4KB) 


Priority of agents 

Max number of existing agents 
Max number of concurrent agents 
Maximum number of idle agents 


Keep DARI process 
Max number of DARI processes 


Index re-creation time 


Transaction manager database name 
Transaction resync interval (sec) 


SPM name 
SPM log size 
SPM resync agent limit 


Workstation name 


Service name 
Transaction program name 
Default accounting string 


IPX/SPX fileserver name 
IPX/SPX DB manager object name 
IPX/SPX socket number 


Directory services type 
Directory path name 
Directory object name 


ADSM node name 
ADSM owner 
ADSM password 


db2 -» 


(SYSADM GROUP) 
(SYSCTRL GROUP) 
(SYSMAINT GROUP) 
(AUTHENTICATION) 
(DFTDBPATH) 


(MON HEAP SZ) 
(UDF MEM SZ) 


(BACKBUFSZ) 
(RESTBUFSZ) 


(AGENT STACK SZ) 
(MIN PRIV MEM) 
(PRIV MEM THRESH) 


(SHEAPTHRES) 
(DIR CACHE) 


(ASLHEAPSZ) 
(RQRIOBLK) 
(DOS_RQRIOBLK) 
(QUERY_HEAP_SZ) 
(DRDA HEAP SZ) 


(AGENTPRI) 
(MAXAGENTS) 
(MAXCAGENTS) 
(MAX IDLEAGENTS) 


(KEEPDARI) 
(MAXDARI) 


(INDEXREC) 


(TM DATABASE) 
(RESYNC INTERVAL) 


(SPM NAME) 
(SPM LOG FILE SZ) 
(SPM MAX RESYNC) 


(NNAME) 


(SVCENAME) 
(TPNAME) 
(DFT. ACCOUNT. STR) 


(FILESERVER) 
(OBJECTNAME) 
(IPX SOCKET) 


(DIR TYPE) 
(DIR PATH NAME) 
(DIR OBJ NAME) 


(ADSM NODENAME) 
(ADSM OWNER) 
(ADSM PASSWORD) 


256 


SERVER 


15 
32767 
4096 
1000 
128 


SYSTEM 
200 
MAXAGENTS 
3 


YES 
MAXAGENTS 


ACCESS 
180 
256 

20 


STATION1 


db2instlc 
В0Е052 


879Е 


МОМЕ 
/.:/subsys/database/ 
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2. N 


- 


3. D 


- 


ode Directory 


Node 1 entry: 


Node name 
Comment 
Protocol 


Symbolic destination name 


Security type 
Node 2 entry: 
Node name 


Comment 
Protocol 


Symbolic destination name 


Security type 


VMNODE 


APPC 
BOECTVM 
PROGRAM 


VSENODE 


APPC 
BOECTVSE 
PROGRAM 


atabase Directory 


Database 1 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 2 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 3 entry: 


Database alias 
Database name 
Database drive 
Database release level 
Comment 

Directory entry type 


Database 4 entry: 


Database alias 
Database name 
Database drive 
Database release level 
Comment 

Directory entry type 


= SRVVSEO1 


= VSENODE 


- DCS 


= SRVVMO1 


- VMNODE 
= DCS 

= SRVOS21 
= Е; 


= Indirect 


= ЅАМРІЕ 
= ЅАМРІЕ 


= 6.00 


= Indirect 


SRVVSEO1 
6.00 


Remote 


SRVVMO1 
6.00 


Remote 


SAMPLE 


6.00 


E: 
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4. Database Connection Services(DCS) Directory 


PS 

DCS 1 entry: 

Local database name = SRVVM01 
Target database name = SRVVMOL 
Application requestor name = 

DCS parameters = ,SRVVMO1 
Comment = 

DCS directory release level = 0x0100 
DCS 2 entry: 

Local database name = SRVVSEO1 
Target database name = SRVVSEO1 
Application requestor name = 

DCS parameters = ,BOE1 
Comment = 

DCS directory release level = 0x0100 
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B.5 AIX Definitions 


MACRO PATH /usr/lpp/internet/db2www/macro 
BINDFILE /usr/lpp/internet/server root/cgi-bin/db2sq1.bnd 
DB2INSTANCE dbadminl 


B.5.1 HTML File for the HOMAG Page 


«html» 


<head><title>Homag Maschinenbau AG and ITSO Boeblingen DB2-Connection-Application</title></head> 


«body» 
«center» 


«table border-0 width-1005 cellpadding-2» 


<tr><td align=center 
<td align=center 
<tr><td align=center 
<td align=center 


</table> 


<h4>Please select the Information, you want to get.</h4> 


</center> 
<br><big> 
«img src="/b 
<hr> 

«img src="/b 
Parts</ 

a> 

<hr> 

«img src="/b 
P 

arts</a> 
<hr> 

«img src="/b 
</big><hr><p 
</body> 
</html> 


ue.gif”><a href-"/cgi-bin/db2www/hompart .d2w/in 


ue.gif^»«a href-"/cgi-bin/db2www/hompart.d2w/in 


ue.gif^»«a hrefz"/cgi-bin/db2www/hompart.d2w/in 


ue.gif”><a href="/cgi-bin/db2www/homcust.d2w/in 
align=left>&copy 1997 Homag AG 


valign=middle><img width=100 src-"homlogo.gif^»«/td» 
valign=middle><font size=7>Homag Maschinenbau AG</td></tr> 
valign=middle><font size=7>IBM ITSO Boeblingen</td> 
valign=middle><img width=100 src="itsologo.gif”></td></tr> 


put?d2wdest=homplist&d2wdsc=Partlists”>Show Partlists</a> 


put ?d2wdest=homcad&d2wdsc=CAD-Drawings”>Show CAD-Drawings for the 


put?d2wdest=homware&d2wdsc=Warehouse-Infos”>Show Warehouse-Info for the 


put”>Show Customer Information</a> 
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B.5.2 D2W Macro for Access to DB2/2 for OS/2 


%DEFINE( 
DATABASE-"OSAMPLE^ 
LOGIN="userid” 
PASSWORD=” password” 


А 
%) 


%SQL MESSAGE { 
100 : ”<center><img src-'/critic b.gif”><hl>Sorry, no Warehouse-Infos for this Part found|</hl><img src-'/critic u.gif/»" : exit 


Е 
%) 


%SQL( 
SELECT A.TNR,A.FIRMA,A.LAGER,A.BESTAND,A.BESTELL,A.MINDEST,A.FESTBSTMGE,A.ANZBEST,B.BEZEICHNUNG 
FROM 11040700 A,I1010T00 B WHERE A.TNR-B.TNR AND A.TNR=’ $(tnr)' 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<h2>Found the following Warehouse-Infos:</h2> 
<h2>Select the Partnumber to view its Partlist|</h2> 
<table border width=100% cellpadding=3> 
<tr><th>Partnumber:</th> 
<th><a href="/cgi-bin/db2www/homplist.d2w/report?d2wdest=homplist&d2wdsc=Partlists&tnr=$(V1)”>$(V1)</th> 
<th>Description:</th> 
<th colspan=4>$(V9)</th></tr> 
<tr><th>Factory No.</th> 
<th>Stock No.</th> 
<th>Stock Quantity</th> 
<th>Purchase Quantity</th> 
<th>Minimum Stock</th> 
<th>Fixed Purchase</th> 
<th>Running eng|Bestellungen</th></tr> 
%ROW{ 
<tr><td align=center>$(V2)</td> 
<td align=center>$(V3)</td> 
<td align=center>$(V4)</td> 
<td align=center>$(V5)</td> 
) 
) 
) 


<td align=center>$(V6)</td> 

<td align=center>$(V7)</td> 

<td а1ідп=сепёег>$ (8) </td></tr> 
%} 
</table> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 


%) 


%HTML REPORT( 

%EXEC SQL 

<hr> 

«img src-"/door02.gif^»«a href="/homstart.html”>Back to Startpage</a> б 

«img src-"/critic q.gif” width=33 height=32><a href="/cgi-bin/db2www/hompart .d2w/input?d2wdest=$ (d2wdest) &d2wdsc=$ (d2wdsc)”>Search 
another Part</a> 

<hr> 

</center> 

&copy 1997 Homag AG 

</html> 


3 
%) 
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B.5.3 D2W Macro for Access to DB2/6000 for AIX 


%DEFINE( 
DATABASE=” SAMPLE” 
LOGIN="dbadmin1” 
PASSWORD="sq11" 


à 
%) 


%SQL MESSAGE { 
100 : ”<center><img src-'/critic b.gif”><hl>Sorry, no CAD-Drawing for this Part found|</hl><img src=’/critic_u.gif’>” : exit 


%) 


%SQL( 
SELECT A.TNR,A.CAD,B.BEZEICHNUNG FROM 11030700 A,I1010T00 B WHERE A.TNR-B.TNR AND A.TNR=’ $(tnr)’ 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<h2>Found the following CAD-Drawing:</h2> 
<h2>Select the Partnumber to view its Partlist|</h2> 
<table border width=100% cellpadding=5> 
RON ( 
<tr><th>Part Number:</th> 
«th align=center><a href="/cgi-bin/db2www/homplist.d2w/report?d2wdest=homplist&d2wdsc=Partlists&tnr=$(V1)”>$(V1)</th> 
<th>Description:</th> 
<th>$(V3)</th></tr> 
<tr><td colspan=5><img src-"$(V2)"«/td»«/tr» 
%) 
</table> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 


kit <tr><td colspan=4><img src-"$(V2)" width=425 height=300></td></tr> **xxxxxx 


à 
%) 


%HTML REPORT( 

%EXEC SQL 

<hr> 

«img srec="/door02.gif”><a href="/homstart.html”>Back to Startpage</a> б 


«img src-"/critic q.gif^ width=33 height=32><a href="/cgi-bin/db2www/hompart .d2w/input?d2wdest=$ (d2wdest) &d2wdsc=$ (d2wdsc)”>Search 


another Part</a> 
<hr> 

</center> 

&copy 1997 Homag AG 
</html> 


В 
%) 
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%DEFINE( 
DATABASE="SAMPLE” 
LOGIN="dbadmin1” 
PASSWORD="sq11" 


%LIST ” AND ” Cond 

Cond="TNR LIKE ’$(Cond1)%’” 

Cond-"BEZEICHNUNG LIKE TRANSLATE ('%$ (Cond2) & ) ^ 
WC-"WHERE $(Cond)^ 


) 


%HTML INPUT( 
<html><title>Find Partnumber</title><center> 
<table border=0> 
<tr><td rowspan=2><img src-"/critic q.gif”></td> 
<td align=center valign=middle><font size=6><b>You want to view $(d2wdsc).</font></b></td> 
«td rowspan=2><img src="/critic q.gif”></td></tr> 
<tr><td align=center valign=middle><font size=6>First find а Partnumber for the Query</font></td> 
</table> 
<h2>Please type the beginning of the Partnumber and/or а Portion of the Description. 
Leave both fields blank for а complete list.</h2> 
<form method="post” action="/cgi-bin/db2www/hompart .d2w/report?d2wdest=$(d2wdest)&d2wdsc=$(d2wdsc)”> 
<table border cellpadding=5> 
<tr><td>Startportion of Partnumber:</td> 
<td><input name-"Condl" size=20 maxlength=10></td></tr> 
<tr><td>Portion of Description:</td> 
<td><input name-"Cond2" size=20 maxlength=10></td></tr> 
<tr><td colspan=2 align=center><input type="submit” value="Find Parts|”></td></tr> 
<tr><td colspan=2 align=center><input type="reset” value="Reset Fields”></td></tr> 
</table> 
</form> 
<hr> 
«img src-"/door02.gif^»«b»«a href="/homstart.html”>Back to Startpage</a></b> 
<hr> 
</center> 
&copy 1997 Homag AG 
</html> 


à 
%) 


Du 


%SQL MESSAGE { 
100 : ”<center><img src-'/critic b.gif/»«hl»Sorry, no Parts found for this Selection|</hl><img sre="/critic u.gif/»" : exit 


Қ 
%) 


%SQL( 
SELECT TNR,BEZEICHNUNG FROM 11010700 $(WC) ORDER BY TNR 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<table border=0> 
<tr><td rowspan=2><img src-"/critic g.gif”></td> 
<td align=center valign=middle><font size=6><b>Query for $(d2wdsc).</font></b></td> 
«td rowspan=2><img src-"/critic g.gif”></td></tr> 
<tr><td align=center valign=middle><font size=6>Found the following Partnumbers.</font></td> 
</table> 
<h2>Please select one of the Numbers to view the Data.</h2> 
<table border width=100% cellpadding=5> 
<tr><th colspan=2 align=center>Select а Partnumber</th> 
<th align=left>Description</th></tr> 
RON ( 
<tr><td align=center><img src="/look.gif”></td> 
«td align=center><a href-"/cgi-bin/db2www/$ (d2wdest) .d2w/report?d2wdest=$ (d2wdest) &d2wdsc=$ (d2wdsc) &tnr=$(V1)”">$(V1)</td> 
<td align=left>$(V2)</td> 
</tr> 
%} 
</table> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 


%) 


%HTML REPORT( 

%EXEC SQL 

<hr> 

«img src-"/door02.gif^»«a href="/homstart.html”>Back to Startpage</a> б 

«img src-"/critic q.gif^ width=33 height=32><a href="/cgi-bin/db2www/hompart .d2w/input?d2wdest=$ (d2wdest) &d2wdsc=$ (d2wdsc)”>Search 
another Part</a> 

<hr> 

</center> 

&copy 1997 Homag AG 

</html> 


à 
%) 
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B.5.4 D2W Macro for Access 


%DEFINE{ 
DATABASE="NTSAMPLE” 
LOGIN-"dbadmin3^ 
PASSWORD" sq13^ 


à 
%) 


%SQL MESSAGE ( 


to DB2 for Windows NT 


100 : ”<center><img src-'/critic b.gif/»«hl»Sorry, no Partlist for this Part found|</hl><img src=’/critic_u.gif’>” : exit 


x 
%) 


&SQL (PARENT) ( 


SELECT TNR,BEZEICHNUNG,ME,BLATTGR,PE,GE FROM I1010T00 WHERE TNR-'$(tnr)' 


%SQL REPORT( 

<html><title>Homag AG Schopf 
<h2>Found the following Part 
<table border cellpadding=3> 


och and IBM ITSO Boeblingen</title><center> 
ist for:</h2> 


<tr><td>Parent-Partnumber:</td> 


<td align=center>$(V1)</ 
<tr><td>Description:</td> 

<td align=center>$(V2)</ 
ROW ( 


d></tr> 


d></tr> 


«tr»«td»eng |Mengeneinheit:«/td» 


«td align=center>$(V3)</ 


h» 


<td>Size of CAD-Drawing:</td> 


<td align=center>$(V4)</ 


<tr><td>eng|Preiseinheit:</td> 


<td align=center>$(V5)</ 


d></tr> 


h> 


<td>eng|Gewichtseinheit:</td> 


<td align=center>$(V6)</ 
%) 


</table> 
<h2>Select the Partnumber to 


%SQL (COMP) ( 
B.BEZEICHNUNG,B.ME AS 


*SQL REPORT( 


r><th>Sequenz</th> 
<th>Component</th> 
<th>Quantity</th> 
</tr> 
<tr><th></th> 


<th>eng |ME</th> 
h>Length</th> 
<th>Width</th> 
</tr> 
%ROW{ 


A 


d></tr> 


view its Warehouse-Info’ s|</h2> 


SELECT A.TNR,A.POSNR,A.KOMPNR,A.ME,A.STUECK,A.LAENGE,A.BREITE, 


ME2,B.BLATTGR,B.PE,B.GE 


FROM I1020T00 A,I1010T00 B WHERE B.TNR=A.KOMPNR AND A.TNR-'$(tnr)' ORDER BY 2 


<b>Contains the following Parts:</b><br><br> 
<table border width=100% cellpadding=2> 
< 


<th colspan=8 align=left>Description</th> 


<tr><td align=center>$(V2)</td> 


<td align=center>$(V5)</td> 
<td colspan=5><td> 
<td align=center>$(V4)</td> 
<td align=center>$(V6)</td> 
<td align=center>$(V7)</td> 
</tr> 
<tr><td></td> 
<td colspan=8 align=left>$(V8) </td> 
<td><b>eng|ME:</b></td><td align=center>$(V9)</td> 
<td><b>CAD-Size:</b></td><td align=center>$(V10) </td> 
<td><b>eng|PE:</b></td><td align=center>$(V11)</td> 
<td><b>eng|GE:</b></td><td align=center>$(V12)</td> 
</tr> 
%} 
</table> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 
%} 
%} 


<td align=center><a href=”/cgi-bin/db2www/homware.d2w/report?d2wdest=homware&d2wdsc=Warehouse- Infos&tnr=$ (V3) ”>$ (V3) </td> 
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%HTML REPORT( 

%ЕХЕС SQL(PARENT) 

%EXEC SQL(COMP) 

<hr> 

«img srec="/door02.gif”><a href="/homstart.html”>Back to Startpage</a> б 
«img src-"/critic q.gif” width=33 height=32><a href="/cgi-bin/db2www/hompart .d2w/input?d2wdest=$ (d2wdest) &d2wdsc=$ (d2wdsc)”>Search 
another Part</a> 

<hr> 

</center> 

&copy 1997 Homag AG 

</html> 


3 
%) 
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B.5.5 D2W Macros for Access to DB2 for VM 


%DEFINE( 
DATABASE="VMSAMPLE” 
LOGIN="c1boevm1” 
PASSWORD=” xmas25mm” 


%LIST ” AND ” Cond 

Cond-"KDNR LIKE ’ $(Cond1)%’” 
Cond-"KKBEZ LIKE ’%$(Cond2)%’” 
WC-"WHERE $(Cond)^ 


%{ the TRANSLATE-Option is not suppoted by DB2 VM 
KKBEZ LIKE TRANSLATE(..Cond2... 


*HTML INPUT( 
<html><title>Find Customer</title><center> 
<table border=0> 
<tr><td rowspan=2><img src-"/critic q.gif”></td> 
<td align=center valign=middle><font size=6><b>You want to view Customer-Infos.</font></b></td> 
«td rowspan=2><img src="/critic q.gif”></td></tr> 
<tr><td align=center valign=middle><font size=6>First find a Customernumber for the Query</font></td> 
</table> 
<h2>Please type the beginning of the Customernumber and/or а Portion of the Name. 
Leave both fields blank for а complete list.</h2> 
<form method="post” action="/cgi-bin/db2www/homcust.d2w/report”> 
<table border cellpadding=5> 
<tr><td>Startportion of Customernumber:</td> 
<td><input name-"Condl" size=10 maxlength=5></td></tr> 
<tr><td>Portion of Name:</td> 
<td><input name-"Cond2" size=20 maxlength=15></td></tr> 
<tr><td colspan=2 align=center><input type="submit” value="Find Customer|”></td></tr> 
<tr><td colspan=2 align=center><input type="reset” value="Reset Fields”></td></tr> 
</table> 
</form> 
<hr> 
«img src-"/door02.gif^»«b»«a href="/homstart.html”>Back to Startpage</a></b> 
<hr> 
</center> 
&copy 1997 Homag AG 
</html> 
%) 


%SQL MESSAGE ( 


100 : ”<center><img src-'/critic b.gif/»«hl»Sorry, no Customer found for this Selection|</hl><img src=’/critic_u.gif’>” : 


5 
%) 


%SQL( 
SELECT KDNR,KKBEZ FROM I1050T00 $(WC) ORDER BY KDNR 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<table border=0> 
<tr><td rowspan=2><img src-"/critic g.gif”></td> 
<td align=center valign=middle><font size=6><b>Query for Customerinfo.</font></b></td> 
«td rowspan=2><img src-"/critic g.gif”></td></tr> 
<tr><td align=center valign=middle><font size=6>Found the following Customernumbers.</font></td> 
</table> 
<h2>Please select one of the Numbers to view the Details.</h2> 
<table border width=70% cellpadding=5> 
<tr><th colspan=2 align=center>Select а Costumernumber</th> 
<th align=left>Name</th></tr> 
ROW ( 
<tr><td align=center><img src="/look.gif”></td> 
«td align=center><a href="/cgi-bin/db2www/homcustl.d2w/report?kdnr=$(V1)”>$(V1)</td> 
<td align=left>$(V2)</td> 
</tr> 
%) 
</table> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 
5} 


В 
%} 


exit 
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%HTML REPORT( 

%EXEC SQL 

<hr> 

«img src-"/door02.gif^»«a href="/homstart.html”>Back to Startpage</a> б 

<img src-"/critic q.gif” width=33 height=32><a href="/cgi-bin/db2www/homcust.d2w/input”>Search another Customer</a> 
<hr> 

</center> 

&copy 1997 Homag AG 

</html> 


2 
%) 


%DEFINE( 
DATABASE="VMSAMPLE” 
LOGIN="c1boevm1” 
PASSWORD=” xmas25mm” 


3 
%) 


%SQL MESSAGE( 
100 : ”<center><img src-'/critic b.gif/»«hl»Sorry, по Customer-Details for this Customernumber found|</hl><img src=’/critic_u.gif’>” 
exit 


The CASE WHEN-Buildin is not supported by DB2 VM: 


CASE 
WHEN KDART="K" THEN 'Customer 

WHEN KDART=’ У” THEN ’ Sales subsidiary’ 
ELSE ’ Unknown’ 

END 
CAS 


DSPSCHL=’ D’ THEN ’ German 
DSPSCHL-'E' THEN ” English 
DSPSCHL-'F' THEN ' French 
DSPSCHL-'I' THEN 'Italian 
DSPSCHL-'S' THEN 'Spanish 
DSPSCHL 


W K 
W K 
W K 
WHEN KI 
W K 
E K 
D 


EN 


3e 


) 


%SQL (HEAD) ( 
SELECT KDNR,KDART, 
KDFEPRO1, КОҒЕРКО2 , KDFEPRO3, KDFEPRO4, KDFEPRO5, KDFEPRO6, KDFEPRO7 , KDFEPRO8, KDFEPRO9, 
KDFEPR10,KDFEPR11,KDFEPR12,KDFEPR13,KDFEPR14,KDFEPR15,KDFEPR16,KDFEPR25, 
KDSPSCHL,KDBONIT,KKBEZ,KDLAND,KDANZAHL,KDUMS FROM I1050T00 WHERE KDNR=’ $(kdnr)' 
%SQL REPORT( 
<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<h2>Found the following Customer-Details:</h2></center> 
%ROW{ 
<table border width=75% cellpadding=3> 
<tr><td><b>$ (V2) «/td»«td»«b»$ (V1) «/td»«/tr» 
<tr><td><b>Name:</td><td><b>$(V22)</td></tr> 
<tr><td>Language:</td><td>$(V20)</td></tr> 
<tr><td>eng|Bonitaet:</td><td>$(V21)</td> 
<td>Country-Key:</td><td>$(V23)</td></tr> 
<tr><td>Numbers of Employees:</td><td>$(V24)</td> 
<td>Turnover:</td><td>$(V25)</td></tr> 
</table> 
<table border width=100% cellpadding=3> 
<tr><th colspan=8>Products</th></tr> 
<tr><th>Kitchen</th><th>Sleeping</th><th>eng|Tonm]oebel</th><th>Tables</th> 
<th>School</th><th>eng|Flurm]oebel</th><th>Livingroom</th><th>Deliverer</th></tr> 
<tr><td align=center>$(V3)</td><td align=center>$(V4)</td><td align=center>$(V5)</td> 
«td align=center>$(V6)</td><td align=center>$(V7)</td><td align=center>$(V8)</td> 
<td align=center>$(V9)</td><td align=center>$(V10)</td></tr> 
<tr><th>Doors</th><th>Profiles</th><th>0ffice</th><th>Store</th> 
<th>Cabinet Shop</th><th>Interior fiters</th><th>Funeral Furniture</th><th>Panels</th></tr> 
<tr><td align=center>$(V11)</td><td align=center>$(V12)</td><td align=center>$(V13)</td> 
<td align=center>$(V14)</td><td align=center>$(V15)</td><td align=center>$(V16)</td> 
<td align=center>$(V17)</td><td align=center>$(V18)</td></tr> 
</table><center> 
%) 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 
%) 


5 
%) 
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%SQL (ADR) ( 

SELECT KDNR,KDADKEY,KDNAM1,KDNAM5 FROM I1055T00 WHERE KDNR=’ $(kdnr)’ 
%SQL_REPORT { 

<h2>Found the following Adresses for this customer:</h2> 

<h4>Select a Adress-Key to view the Adress-Details</h4></center> 
<table border width=100% cellpadding=3> 

<tr><th>Customer No.</th><th>Adress-Key</th><th>Name</th><th>City</th> 
ROW ( 

<tr><td align=center>$(V1)</td> 


«td align=center><a href="/cgi-bin/db2www/homcust2.d2w/report?kdnr=$(V1)&adrk=$(V2)”>$(V2)</td> 


<td align=center>$(V3)</td><td align=center>$(V4)</td></tr> 
%) 
</table><center> 
<p><b>Select successful. $(ROW NUM) Rows selected.</b> 


%) 


%HTML REPORT( 

%EXEC SQL(HEAD) 

%EXEC SQL(ADR) 

<hr> 

«img src-"/door02.gif^»«a href="/homstart.html”>Back to Startpage</a> б 


<img src-"/critic q.gif” width=33 height=32><a href="/cgi-bin/db2www/homcust.d2w/input”>Search another Customer</a> 


<hr> 

</center> 

&copy 1997 Homag AG 
</html> 


А 
%) 


%DEFINE{ 

DATABASE=” VMSAMPLE” 
LOGIN-"clboevml^ 
PASSWORD-" хтаѕ25тт” 


à 
%) 


%SQL MESSAGE ( 


100 : ”<center><img src=’/critic_b.gif’><hl>Sorry, no Customer-Details for this Customernumber 


: exit 


К 
%} 


&SQL( 

SELECT KDNR,KDADKEY,KDTEL,KDTELEX,KDTELEFA,KDTELTEX,KDANR, 
KDNAM1 , KDNAM2 , KDNAM3 , KDNAM4 , KDNAM5 , KDNAM6 , KDTLORT , KDINTTX 
FROM 11055700 WHERE KDNR=’ $(kdnr)’ AND KDADKEY=’ $(adrk)’ 
%SQL REPORT( 

<html><title>Homag AG Schopfloch and IBM ITSO Boeblingen</title><center> 
<h2>Found the following Customer-Adress-Details:</h2></center> 
<table border width=75% cellpadding=3> 

<tr><td><b>$(V1), $(V2)«/td» 

RON ( 

r»«td»Adress:«/td»«td»$ (V7) «/td»«/tr» 
r»«td»«/td»«td»$ (V8) «/td»«/tr» 
r><td></td><td>$(V9)</td></tr> 
r><td></td><td>$(V10)</td></tr> 
r»«td»«/td»«td»$ (V11) «/td»«/tr» 
r><td></td><td>$(V12)</td></tr> 
r><td></td><td>$(V13)</td></tr> 
r><td></td><td>$(V14)</td></tr> 

r><td>Telefon: $(V3)</td><td>Telex: $(V4)</td></tr> 
r><td>Telefax: $(V5)</td><td>Teletext: $(V6)</td></tr> 
tr><td colspan=2>Internal Text: $(V15)</td></tr> 


лл^А ЛА ЛА ЛА Л Л Л Л Л 


/table><center> 
p><b>Select successful. $(ROW NUM) Rows selected.</b> 


«img src-"/door02.gif^»«a href="/homstart.html”>Back to Startpage</a> б 


<img src-"/critic q.gif” width=33 height=32><a href="/cgi-bin/db2www/homcust.d2w/input”>Search another Customer</a> 


<hr> 

</center> 

&copy 1997 Homag AG 
</html> 


н 
%} 
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B.6 Windows NT Definitions 


The following are the definitions we used in our Windows NT stations. 


B.6.1 DB/2 for Windows NT Database Definitions 


B.6.1.1 Node Directory Entries for DB2 Windows NT 


db2 => list node directory 


Node Directory 


Node 1 entry: 


Node name 
Comment 
Protocol 
Hostname 
Service name 


Node 2 entry: 


Node name 
Comment 
Protocol 
Hostname 
Service name 


Node 3 entry: 


Node name 

Comment 

Protocol 

Symbolic destination name 
Security type 


Node 4 entry: 


Node name 

Comment 

Protocol 

Symbolic destination name 
Security type 


db2 => 


Number of entries in the directory = 4 


OSNODE 


TCPIP 
itsops3 
db2instlc 


AIXNODE 


TCPIP 
itsol 
db2instlc 


VMNODE 


APPC 
BOECTVM 
PROGRAM 


VSENODE 


APPC 
BOECTVSE 
PROGRAM 
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B.6.1.2 Database Directory Entries for DB2 Windows NT 


ES 
db2 => list database directory 

System Database Directory 

Number of entries in the directory = 7 
Database 1 entry: 

Database alias = OSAMPLE 

Database name - SAMPLE 

Node name = OSNODE 

Database release level = 6.00 

Comment = 0S/2 Sample DB 
Directory entry type = Remote 
Authentication = Server 
Database 2 entry: 

Database alias = VMDB2 

Database name = SRVVMOL 

Node name = VMNODE 

Database release level = 6.00 

Comment = VM/DB2 Sample DB 
Directory entry type = Remote 
Authentication = DCS 
Database 3 entry: 

Database alias = VSEDB2 

Database name = SRVVSEOL 

Node name = VSENODE 

Database release level = 6.00 

Comment = VSE/DB2 Sample DB 
Directory entry type = Remote 
Authentication = DCS 
Database 4 entry: 

Database alias = ASAMPLE 

Database name = SAMPLE 

Node name = AIXNODE 

Database release level = 6.00 

Comment = AIX DB2/6000 Sample DB 
Directory entry type = Remote 
Authentication = Server 
Database 5 entry: 

Database alias = SAMPLE 

Database name = SAMPLE 

Local database directory C:\DB2 

Database release level = 6.00 

Comment = W/NT DB2 Sample DB 
Directory entry type = Indirect 
Authentication = Server 

cont ... 
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Database 6 entry: 


Database alias 
Database name 


Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


Database 7 entry: 


Database alias 
Database name 

Node name 

Database release level 
Comment 

Directory entry type 
Authentication 


db2 => 


db2 => list dcs directory 


DCS 1 entry: 


Local database name 

Target database name 
Application requestor name 
DCS parameters 

Comment 

DCS directory release level 


DCS 2 entry: 


Local database name 

Target database name 
Application requestor name 
DCS parameters 

Comment 

DCS directory release level 


db2 => 
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B.6.1.3 DCS Entries for DB2 Windows NT 


VMSAMPL 
SRVVMO1 
OSNODE 


= 6.00 


VM/DB2 Sample DB via 0S/2 
Remote 
DCS 


VSESAMPL 
SRVVSEO1 
OSNODE 


= 6.00 


VM/DB2 Sample DB via 0S/2 
Remote 
DCS 


Database Connection Services (DCS) Directory 


Number of entries in the directory = 2 


VMDB2 
SRVVMO1 


SRVVMO1 
DCS VM DB/2 


= 0х0100 


VSEDB2 
SRVVSEO1 


BOE1 
DCS VSE DB/2 


= 0x0100 


B.6.2 SNA Server 


for Windows NT Definitions 


B.6.2.1 Configuration File com.cfg 
Following is the configuration file of the SNA Server Version 3. The name of the 


configuration file is \SNA\SYSTEM\CONFIG\COM.CFG. You access it with the 


following command: snacfg #\sna\system\config\com.cfg 


- 


POOL ІРІТІ 
Роо1 Мате ІРІТІ 
LU Туре Display 
Display Model Mod3 


Allow Model Override Yes 
Comment Created by 3270 


LUs assigned to this pool: 


IP1T1302 Created by 3270 Wizard 
IP1T1303 Created by 3270 Wizard 
IP1T1304 Created by 3270 Wizard 
IP1T1305 Created by 3270 Wizard 


Users this pool is assigned to: 
DBADMIN3 DB2-Administrator 
DBADMIN1 DB2-Administrator 
DB2NTCLIENT db2 windows nt client 


MODE INTER 


Mode Name #INTER 

Comment Interactive 

Session Limit 8 

Min Con Winners 4 

Min Con Losers 0 

Autoactivation Lim 0 

Enable Autopartner No 

High Priority Yes 

Pacing Send Count 7 

Pacing Recv Count 7 

Max Send RU 1024 

Max Receive RU 1024 
MODE #INTERSC 

Mode Name #INTERSC 

Comment Interactive 

Session Limit 8 

Min Con Winners 4 

Min Con Losers 0 

Autoactivation Lim 0 

Enable Autopartner No 

High Priority Yes 

Pacing Send Count 7 

Pacing Recv Count 7 

Max Send RU 1024 

Max Receive RU 1024 


Wizard 


cont ... 
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MODE £BATCH 


Mode Name 

Comment 

Session Limit 

Min Con Winners 
Min Con Losers 
Autoactivation Lim 
Enable Autopartner 
High Priority 
Pacing Send Count 
Pacing Recv Count 
Max Send RU 

Max Receive RU 


MODE £BATCHSC 


Mode Name 

Comment 

Session Limit 

Min Con Winners 
Min Con Losers 
Autoactivation Lim 
Enable Autopartner 
High Priority 
Pacing Send Count 
Pacing Recv Count 
Max Send RU 

Max Receive RU 


MODE BLANK 


Mode Name 

Comment 

Session Limit 

Min Con Winners 
Min Con Losers 
Autoactivation Lim 
Enable Autopartner 
High Priority 
Pacing Send Count 
Pacing Recv Count 
Max Send RU 

Max Receive RU 
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#BATCH 
Batch 


#BATCHSC 
Batch 


BLANK 
8 Blank chars 


cont .... 


M cont 
MODE QPCSUPP 
Mode Name QPCSUPP 
Comment 5250 Mode 
Session Limit 64 
Min Con Winners 32 
Min Con Losers 0 
Autoactivation Lim 0 
Enable Autopartner Yes 
High Priority Yes 
Pacing Send Count 7 
Pacing Recv Count 7 
Max Send RU 1024 
Max Receive RU 1024 
MODE QSERVER 
Mode Name QSERVER 
Comment CA/400 Mode 
Session Limit 64 
Min Con Winners 32 
Min Con Losers 0 
Autoactivation Lim 0 
Enable Autopartner Yes 
High Priority Yes 
Pacing Send Count 7 
Pacing Recv Count 7 
Max Send RU 1024 
Max Receive RU 1024 
MODE IBMRDB 
Mode Name IBMRDB 
Comment APPC Mode for DRDA 
Session Limit 20 
Min Con Winners 10 
Min Con Losers 10 
Autoactivation Lim 0 
Enable Autopartner No 
High Priority No 
Pacing Send Count 4 
Pacing Recv Count 4 
Max Send RU 1024 
Max Receive RU 1024 
SERVER SRVWNT 
Server Name SRVWNT 
Comment ITSO Win/NT SNA Server 
Control Point Name ІРІРІЗСР 
Network Name DEIBMIP1 
Link Services associated with this Server: 
SNADLC1 Ѕпар1с1 
SNAREM1 SnaRem1 
cont .... 
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Connections associate 
1Р1 Created 


APPC Local LUs associ 
LOCNT Local А 


LINK SNADLC1 


Link Service Name 
Server Name 
Comment 

Link Service Type 


Connections associate 
1Р1 Created 


LINK SNAREM1 


Link Service Name 
Server Name 
Comment 

Link Service Type 


No Connections associ 


CONNECTION IP1 


Connection Name 
Server Name 

Comment 

Remote End 
Activation type 
Dynamic LU Definition 
Call Direction 
Local Block Number 
Local Node Number 
Control Point Name 
Network Name 

Remote Block Number 
Remote Node Number 


Primary Link Service 


Connection Type 

DLC Type 

XID Format 

Remote Network Addres 
Remote SAP Address 
Max BTU Length 
Receive ACK Threshold 
NAK Send Limit 

Retry Limit 

XID Retry Limit 

T1 Timeout 

T2 Timeout 

Ti Timeout 
Reactivation Delay 
Reactivation Retry Li 


d with this Server: 
by 3270 Wizard 


ated with this Server: 
PPC LU 


SNADLC1 
SRVWNT 
Ѕпар1с1 
Token Ring 


d with this Link Service: 
by 3270 Wizard 


SNAREM1 
SRVWNT 
SnaRem1 
Token Ring 


ated with this Link Service. 


IP1 
SRVWNT 


Created by 3270 Wizard 


Host 

Initially Active 
No 

Outgoing 

05D 

00000 


SNADLC1 


802.2 DLC 
Token 
Format3 
S 400023700601 
4 
1929 
2 
8 
10 
3 
Default 
Default 
Default 
Default 
mit None 


cont ... 
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3270 LUs assigned to this Connection: 
IP1T1302 Created by 3270 Wizard 
IP1T1303 Created by 3270 Wizard 
IP1T1304 Created by 3270 Wizard 
IP1T1305 Created by 3270 Wizard 


No LUA LUs assigned to this Connection. 
No Downstream LUs assigned to this Connection. 
APPC LUs assigned to this Connection: 


VSEDB2 APPC-Connection to CICS 
VMDB2 APPC-Connection to VM 


LU IP1T1302 


LU Name IP1T1302 

LU Number 2 

Connection IP1 

Comment Created by 3270 Wizard 
Pool 1Р1Т1 

LU Type Display 

Display Model Mod3 


Allow Model Override Yes 


No Users to which this LU is assigned. 


LU IP1T1303 


LU Name IP1T1303 

LU Number 3 

Connection IP1 

Comment Created by 3270 Wizard 
Pool ІРІТІ 

LU Type Display 

Display Model Mod3 


Allow Model Override Yes 


No Users to which this LU is assigned. 


LU IP1T1304 


LU Name IP1T1304 

LU Number 4 

Connection IP1 

Comment Created by 3270 Wizard 
Pool 1Р1Т1 

LU Type Display 

Display Model Mod3 


Allow Model Override Yes 


No Users to which this LU is assigned. 
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LU IP1T1305 


LU Name IP1T1305 

LU Number 5 

Connection IP1 

Comment Created by 3270 Wizard 
Роо1 1Р1Т1 

LU Type Display 

Display Model Mod3 


Allow Model Override Yes 


No Users to which this LU is assigned. 


APPCRLU VSEDB2 


LU Alias VSEDB2 

Connection Name IP1 

Network Name DEIBMIP1 

LU Name ІР1АМС 

Uninterpreted LU Name IP1AMC 

Comment APPC-Connection to CICS 
Parallel sessions Yes 

Automatic partnering No 

Session level security None 

Implicit Mode IBMRDB 


This LU has no partner LUs. 


APPCRLU VMDB2 


LU Alias VMDB2 

Connection Name IP1 

Network Name DEIBMIP1 

LU Name IP1AITSO 
Uninterpreted LU Name IP1AITSO 

Comment APPC-Connection to VM 
Parallel sessions Yes 

Automatic partnering No 

Session level security None 

Implicit Mode IBMRDB 


This LU has no partner LUs. 


APPCLLU LOCNT 


LU Alias LOCNT 

Server Name SRVWNT 
Independent LU Yes 

Network Name DEIBMIP1 

LU Name IP1P13CO 
Comment Local APPC LU 
Automatic partnering No 

Member of def. pool No 

Implicit remote LU «none» 
Timeout for TP start 60 


This LU has no partner LUs. 
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cont .... 


a FA 

Sate ate cont 

USER DBADMIN3 
User Name DBADMIN3 
Domain SRVWNT 
Comment DB2-Administrator 
Default Local LU LOCNT 
Default Remote LU VMDB2 
LUs and Pools assigned to this user: 
ІРІТІ Created by 3270 Wizard 

USER DBADMIN1 
User Name DBADMIN1 
Domain SRVWNT 
Comment DB2-Administrator 
Default Local LU «none» 
Default Remote LU «none» 
LUs and Pools assigned to this user: 
ІРІТІ Created by 3270 Wizard 

USER DB2NTCLIENT 
User Name DB2NTCLIENT 
Domain SRVWNT 
Comment db2 windows nt client 
Default Local LU <none> 
Default Remote LU <none> 
LUs and Pools assigned to this user: 
ІРІТІ Created by 3270 Wizard 

CPIC BOECTVSE 
SymDest Name BOECTVSE 
Comment CPIC for VSEDB2 
Application TP Name BOE1 
Partner LU Alias VSEDB2 
Mode Name IBMRDB 
Conversation Security Type Same 

CPIC BOECTVM 
SymDest Name BOECTVM 
Comment CPIC for VMDB2 
Application TP Name SRVVM01 
Partner LU Alias VMDB2 
Mode Name IBMRDB 
Conversation Security Type Same 

DIAGNOSTIC 
Audit Level Level 10 
Popup Server SRVWNT 
Logging Server SRVWNT 
Network Management Conn <none> 
Display/CNOS Conn IP1 
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B.6.3.1 Definition of /etc/hosts/ 


The definition of the hosts for TCP/IP is for Windows NT in the Path 


\Winnt\system32\drivers\etc\hosts. This is our hosts definition: 


- 


Шы cH ж SHR OH I ЧЕ SHR Hs ЧЕ Мы: cH SHES ч. 


27.0 


оо охо tO O iO iO н 


[29] 
mm 


.164. 
.164. 
.164. 
.164. 
.164. 
.164. 
.164. 


102.54 
38.25 


.0.1 


178. 
178. 
178. 
178. 
178. 
178. 
178. 
.1.128 


103 
104 
105 
106 
107 
108 
109 


Copyright (c) 1993-1995 Microsoft Corp. 


For example: 


.94.97 rhino.acme.com 
.63.10 х.асте.сот 


localhost 

itsol itsol.sw.boeblingen.ibm.com 
11502 

itsopsl 

itsops2 

itsops3 

itsops4 

itsops5 

wagner 


# 
# 
# 
# 
# 
# 
# 


# source server 
# x client host 


AIX Station 
AIX Station 
Win/NT Station 
05/2 Station 
05/2 Station 
Win95 Station 
05/2 Notebook 


# ITSO Austin 


This is a sample HOSTS file used by Microsoft TCP/IP for Windows NT. 


This file contains the mappings of IP addresses to host names. Each 
entry should be kept on an individual line. The IP address should 
be placed in the first column followed by the corresponding host name. 
The IP address and the host name should be separated by at least one 

space. 


Additionally, comments (such as these) may be inserted on individual 
lines or following the machine name denoted by a ’#’ symbol. 


оз го нљ ол о 
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Appendix C. Data Replication Implementation for OS/2 


C.1 Installing DB2 Universal Database 


Now that you have installed the DpropR Capture for VM, you can proceed with 
the OS/2 installation. Data Replication can be administered from the DB2 
Universal Database for OS/2. To install the Replication Administration it is 
assumed а source database on VM or VSE system and а target database on an 
OS/2 system, and two administrators are defined in UPM - ASN, and USERID (the 
default). 


The following sample instructions are for installing the Workgroup Edition. 
Repeat the procedure for each feature you want to install. 


From the CD-ROM icon, open the DB2 Directory then open the EN Directory. 
Select INSTALL.EXE. 


Figure 164. Universal Database - Installation and Maintenance 


From the Installation and Maintenance screen, you can choose which kind of 
database you would like to install: IBM DB2 Universal Database Workgroup 
Edition or IBM DB2 Universal Database Enterprise Edition. In our case we chose 
the former. Click on Action and select Install. You will receive а panel 
informing you of the Product Number, the Version and Feature. Click "OK" to 
begin the installation. 


On the next panel "Select АШ” to install the feature. If you want to change the 
Target Directory, go to "Disk Space" and click "Install". 
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Figure 165. Universal Database - Install - Directories 


Type the name of the DB2 System, and see help for more information. Type а 
name for your System Database. Click ”NEXT”. Choose ”Configure...” to 
configure communication protocol to Default Instance. In properties, configure 
the protocol specific parameters (such as workstation NNAME for NETBIOS). 
Choose "Configure..." to configure the communication protocol to Administration 
Server, "OK" to continue. 


Figure 166. Universal Database - Specify System Name 
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You must supply the TP Name that you intend to use to access the host database 
via APPC Protocol. Click ”OK” to go back to the previous panel. 


Check: Auto start default instance at boot time to auto-start the default instance, 
and click ”NEXT”. 


Figure 167. Universal Database - Configure Default Instance - APPC Protocol 


Type the User ID and Password that the Administration Server will use to log on 
to your system. This is an Administrator User ID. You must supply the Verify 
Password. Click ”Done” to install the product. 


Figure 168. Universal Database - Installation Command 


On the next panel, just click ”OK”. After the install is done, reboot the system. 
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Figure 169. Universal Database - Installation and Maintenance 


C.2 Post-install Activities 
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After DB2 installation and workstation reboot, close the ”First Steps” window and 
perform the following tasks: DDCS is required for remote database connections. 
Assuming that DDCS gateway and host databases are correctly defined on the 
DDCS gateway, issue the following to catalog the DDCS gateway, according to 
the type of connection at your installation. The following are the commands we 
issued for our case. 


1. Catalog node and instance for the DDCS gateway. 


db2 catalog appc node VMNODE remote BOECTVM security PROGRAM 
system VM 


You have to catalog each node that you will use to replicate data. 


In our case we cataloged the VM node, the VSE node, the AIX node, the 
Windows NT node and the OS/2 node. VM and VSE are APPC nodes. The 
others are TCP/IP nodes. 


2. Catalog the host database: 
db2 catalog database SRVVMO1 as SRVVMO1 at УМ01 authentication DCS 


3. After the procedures listed below you should be able to connect to the host 
database: 


Db2 Connect to SRVVMO1 


When asked for node logon, provide the user ID and password of a valid 
user that is known on the host system, and has DBA privileges on the 
database. 


4. Bind the DDCS utilities for the source database: 
db2 bind sgllibibnd 2 ddcsvm.Ist blocking all sqlerror continue 


You will see 0 errors and 902 warnings from the bind command (for VM 
host). 


or 
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db2 bind\sqllib\ond\@ddcsvse.Ist blocking all sglerror continue 


Each bind may take as long as 15 minutes. 


db2 connect reset 


5. Create a local DB2 test database: 


db2start 


db2 create database asntest 


Note: We recommend you do this from an OS/2 command line, and not from 
FirstSteps in DB2. 


6. Perform binding for the local (target) database: 


db2 connect to asntest 


db2 bind \sqllib\ond\@db2ubind.Ist blocking all grant public 


(You will see 0 errors and 2 warnings from the bind command.) 


db2 bind \sqllib\bnd\@db2cli.lst blocking all grant public 


db2 connect reset 


C.3 Configuring for VM and VSE Hosts 


For non-common server host platforms (MVS, VM, VSE), you must edit the 
DPCNTL.SQL file found in the \SQLLIB\BIN directory. This file contains 
statements that Control Center uses to automatically create non-CS Capture 


control tables when the first replication action is attempted. Instructions on how 
to edit this file for the different platforms are embedded in comments within the 


file. 


Make sure the Capture control tables are created on the source (VM or VSE) 
database. This can be done from the Control Center, by either performing а 


replication action, or by manually running the DPCNTL.SQL file from a RUN SQL 
FILES window. This must be done before binding Apply. 


Execute the following SQL statements against the VM or VSE database, after the 
Capture control tables have been created: 


GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 
GRANT ALL ON 


ASN. 
ASN. 
ASN. 
ASN. 
ASN. 
ASN. 
ASN. 
ASN. 
ASN. 


IBMSNAP REGISTER ТО NULLID WITH GRANT OPTION 
IBMSNAP SUBS SET TO NULLID WITH GRANT OPTION 
IBMSNAP SUBS COLS TO NULLID WITH GRANT OPTION 
IBMSNAP SUBS STMTS TO NULLID WITH GRANT OPTION 
IBMSNAP SUBS MEMBR TO NULLID WITH GRANT OPTION 
IBMSNAP SUBS EVENT TO NULLID WITH GRANT OPTION 
IBMSNAP CRITSEC TO NULLID WITH GRANT OPTION 
IBMSNAP UOW TO NULLID WITH GRANT OPTION 
IBMSNAP PRUNCNTL ТО NULLID WITH GRANT OPTION 


C.4 Installing and Configuring Apply/2 


After installing the Enterprise Edition or the Workgroup Edition or the Personal 


Edition, the Apply files will reside in the \SQLLIB\APPLY directory. 


Ensure that а user logon named ASN exists on your system. 
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If Apply will be done on а remote machine to which the Control Center has no 
links, then do the following: 


Create an OS/2 command file named PCTABLES.CMD, from the softcopy 
README file on the CD. Run the .CMD file. This creates a dummy set of Capture 
control tables on the target database, which Apply needs to successfully bind the 
target. 


Copy the files from the SQLLIBVAPPLY directory to your Apply directory on the 
machine where you want to run Apply. 


If Apply will be run on a machine to which the Control Center has a link, then 
define the Replication Sources and Subscriptions before running the binds. 


Bind Apply to your source and target database. 

db2 connect to SRVVMO1 

db2 bind \sqllib\apply\@applycs.Ist isolation cs blocking all sglerror continue 
db2 bind \sqllib\apply\@applyur.Ist isolation ur blocking all sglerror continue 
db2 connect reset 

db2 connect to dproprdb 

db2 bind \sqllib\apply\@applycs.Ist isolation cs blocking all 

(You may get a CALL error on the above command, but this is not a problem). 
db2 bind \sqllib\apply\@applyur.|Ist isolation ur blocking all 


db2 connect reset 


Install Limitations 


It is strongly recommended that you reboot each time after you install one of the 
product features listed in the catalog. Otherwise, you will encounter problems 
with installing subsequent features, such as it wanting to default to C:\SQLLIB 
and not letting you tell it which directory to use. 


Error messages may appear at the beginning of the installation procedure for a 
feature, but the install will succeed anyway. 
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Appendix D. Special Notices 


This publication is intended to provide system programmers and database 
administrators guidance in the setup and usage of the new functions and 
features of DB2 Server for VSE & VM Version 5 Release 1. 


The information in this publication is not intended as а specification of any 
programming interfaces that are provided by DB2 Server for VSE & VM Version 5 
Release 1 or any of its features. See the PUBLICATIONS section of the IBM 
Programming Announcement for DB2 Server for VSE & VM Version 5 Release 1 
for more information on what publications are considered to be product 
documentation. 


References in this publication to IBM products, programs or services do not 
imply that IBM intends to make these available in all countries in which IBM 
operates. Any reference to an IBM product, program, or service is not intended 
to state or imply that only IBM's product, program, or service may be used. Any 
functionally equivalent program that does not infringe any of IBM's intellectual 
property rights may be used instead of the IBM product, program or service. 


Information in this book was developed in conjunction with use of the equipment 
specified, and is limited in application to those specific hardware and software 
products and levels. 


IBM may have patents or pending patent applications covering subject matter in 
this document. The furnishing of this document does not give you any license to 
these patents. You can send license inquiries, in writing, to the IBM Director of 
Licensing, IBM Corporation, 500 Columbus Avenue, Thornwood, NY 10594 USA. 


Licensees of this program who wish to have information about it for the purpose 
of enabling: (i) the exchange of information between independently created 
programs and other programs (including this one) and (ii) the mutual use of the 
information which has been exchanged, should contact IBM Corporation, Dept. 
600A, Mail Drop 1329, Somers, NY 10589 USA. 


Such information may be available, subject to appropriate terms and conditions, 
including in some cases, payment of a fee. 


The information contained in this document has not been submitted to any 
formal IBM test and is distributed AS IS. The information about non-IBM 
(“vendor”) products in this manual has been supplied by the vendor and ІВМ 
assumes no responsibility for its accuracy or completeness. The use of this 
information or the implementation of any of these techniques is a customer 
responsibility and depends on the customer's ability to evaluate and integrate 
them into the customer's operational environment. While each item may have 
been reviewed by IBM for accuracy in a specific situation, there is no guarantee 
that the same or similar results will be obtained elsewhere. Customers 
attempting to adapt these techniques to their own environments do so at their 
own risk. 


Any performance data contained in this document was determined in a 
controlled environment, and therefore, the results that may be obtained in other 
operating environments may vary significantly. Users of this document should 
verify the applicable data for their specific environment. 
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The following terms are trademarks of the International Business Machines 


Corporation in the United States and/or other countries: 


3090 

400 

AIX 
AS/400 
C/370 

CICS 

CT 

Current 
DataHub 
DataPropagator 
DB2/2 

DFS 
DFSMS/VM 


DProp 

ECKD 

ESCON 

ІМ 

ISSC 

Micro Channel 
Nways 

OS/3 

О5/400 
Presentation Manager 
PS/2 

RAMAC 
RS/6000 
S/370 

SKI 

SQL Master 
System/390 


Visual Warehouse 
VSE/ESA 
XT 


3890 
ACF/VTAM 
APPN 

AT 

C/VM 
CICS/VSE 
CUA 
DataGuide 
DataJoiner 
DB2 
DB2/6000 
DFSMS 


Distributed Relational Database 


Architecture 
DRDA 
ES/9000 

IBM 

IMS 


Language Environment 


Net.Data 
OS/2 

OS/390 
Power Series 
PROFS 

QMF 

RISC System/6000 
RT 

S/390 

SP 

SQL/DS 


Virtual Machine/Enterprise Systems 


Architecture 
VM/ESA 
VTAM 


The following terms are trademarks of other companies: 


Applet 
Approach 

C-bus 

CA 

Digital 

Gateway 
Hewlett-Packard 
HP 

Java and HotJava 
Intel 

Lotus 
Macintosh 
Microsoft 
Windows 
Windows NT 
Windows 95 logo 
MS 

Netscape (logo) 
NetWare 
Networking 
Novell 
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Wilson Window Ware 

Lotus Development Corporation 
Corollary, Inc. 

Computer Associates 

Digital Equipment Corporation 
Gateway Systems Corporation 
Hewlett-Packard Company 
Hewlett-Packard Company 


Trademarks of Sun Microsystems, Incorporated 


Intel Corporation 
Lotus Development Corporation 
Apple Computer, Incorporated 


Trademarks or registered trademarks of Microsoft 


Corporation 


Microsoft Corporation 


Netscape Communications Corporation 


Novell, Incorporated 
UNISYS, Incorporated 
Novell, Incorporated 


NT 
Oracle 
PC Direct 


Pentium 
MMX 
ProShare 
LANDesk 
ActionMedia 
PostScript 
Solaris 
Sybase 
System 7 
Telex 
UNIX 


Wizard 
X/Open 


Northern Telecom Limited or Microsoft Corporation 
Oracle Corporation 

Trademark of Ziff Communications Company; used by 
IBM Corporation under license. 

Trademarks or registered trademarks of Intel Corporation 
in the U.S. and other countries 


Adobe Systems, Incorporated 

Sun Microsystems, Incorporated 

Sybase Corporation 

Apple Computer, Incorporated 

Telex Computer Products Incorporated 

Registered trademark in the United States and other 
countries licensed exclusively through X/Open Company 
Limited 

Sharp Corporation (for hand-held, electronic organizers) 
X/Open Company Limited 


Other company, product, and service names may be trademarks or service 


marks of others. 
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Appendix E. Related Publications 


The publications listed in this section are considered particularly suitable for a 
more detailed discussion of the topics covered in this redbook. 


E.1 International Technical Support Organization Publications 


For information on ordering these ITSO publications see "How to Get ITSO 
Redbooks" on page 267. 


e DB2 Recovery on VSE and VM Using the Data Restore Feature, SG24-2039 
* VTAM 4.2 Implementation and Usage for VM/ESA and VSE/ESA, SG24-4556 


* 3746 Nways Controller M 950 and M 900 APPN Implementation Guide, 
GG24-2536 


* 3174 APPN Implementation Guide Update, SG24-4171 


* How to Get to DB2 from VSE/VSAM Using DB2 VSAM Transparency for 
VSE/ESA, SG24-4931 


E.2 Redbooks on CD-ROMs 


Redbooks are also available on CD-ROMs. Order a subscription and receive 
updates 2-4 times a year at significant savings. 


CD-ROM Title Subscription Collection Kit 
Number Number 
System/390 Redbooks Collection SBOF-7201 SK2T-2177 
Networking and Systems Management Redbooks Collection SBOF-7370 SK2T-6022 
Transaction Processing and Data Management Redbook SBOF-7240 SK2T-8038 
AS/400 Redbooks Collection SBOF-7270 SK2T-2849 
RS/6000 Redbooks Collection (HTML, BkMgr) SBOF-7230 SK2T-8040 
RS/6000 Redbooks Collection (PostScript) SBOF-7205 SK2T-8041 
Application Development Redbooks Collection SBOF-7290 SK2T-8037 
Personal Systems Redbooks Collection SBOF-7250 SK2T-8042 


E.3 Other Publications 
These publications are also relevant as further information sources. 
* DB2 for VM System Administration, GC09-2405 
* DB2 for VM Database Administration, GC09-2388 
* DB2 for VM Operations, SC09-2400 
e DB2 for VM Application Programming, SC09-2392 
* DB2 for VM Database Service Utility, SH09-8088 
* DB2 for VM Diagnosis Guide and Reference, SC09-2407 
* Control Center for VM Installation and Operations Guide, SC67-0205 
e DB2 for VSE Database Administration, GC09-2389 
* DB2 for VSE System Administration, GC09-2406 
* DB2 for VSE Operation, SC09-2401 
e DB2 for VSE Application Programming, SC09-2393 
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* DB2 for VSE Database Service Utility, SC09-2395 

• DB2 for VSE Diagnosis Guide and Reference, LH09-8093 

* DB2 for VSE 8 VM Data Restore Guide Version 5 Release 1, SC09-2275 
* Control Center for VSE Installation and Operations Guide, SC17-2000 

* VSE System Control Statements, SC33-6513 

e VSE/Virtual Storage Access Method: Commands and Macros, SC33-6532 
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How to Get ITSO Redbooks 


This section explains how both customers and IBM employees can find out about ITSO redbooks, CD-ROMs, 
workshops, and residencies. A form for ordering books and CD-ROMs is also provided. 


This information was current at the time of publication, but is continually subject to change. The latest 
information may be found at http://www.redbooks. ibm. com. 


How IBM Employees Can Get ITSO Redbooks 


Employees may request ITSO deliverables (redbooks, BookManager BOOKs, and CD-ROMs) and information about 
redbooks, workshops, and residencies in the following ways: 


* PUBORDER — to order hardcopies in United States 
* GOPHER link to the Internet - type GOPHER.WTSCPOK. ITSO.IBM.COM 
* Tools disks 
To get LIST3820s of redbooks, type one of the following commands: 


TOOLS SENDTO EHONE4 TOOLS2 REDPRINT GET SG24xxxx PACKAGE 
TOOLS SENDTO CANVM2 TOOLS REDPRINT GET SG24xxxx PACKAGE (Canadian users only) 


To get BookManager BOOKs of redbooks, type the following command: 
TOOLCAT REDBOOKS 
To get lists of redbooks, type one of the following commands: 


TOOLS SENDTO USDIST MKTTOOLS MKTTOOLS GET ITSOCAT TXT 
TOOLS SENDTO USDIST MKTTOOLS MKTTOOLS GET LISTSERV PACKAGE 


To register for information on workshops, residencies, and redbooks, type the following command: 
TOOLS SENDTO WTSCPOK TOOLS ZDISK GET ITSOREGI 1996 
For a list of product area specialists in the ITSO: type the following command: 
TOOLS SENDTO WTSCPOK TOOLS ZDISK GET ORGCARD PACKAGE 
* Redbooks Web Site on the World Wide Web 
http://w3.itso.ibm.com/redbooks 
* IBM Direct Publications Catalog on the World Wide Web 
http://www.elink.ibmlink.ibm.com/pbl/pbl 
IBM employees may obtain LIST3820s of redbooks from this page. 
* REDBOOKS category on INEWS 
* Online — send orders to: USIB6FPL at IBMMAIL or DKIBMBSH at IBMMAIL 
* Internet Listserver 


With an Internet e-mail address, anyone can subscribe to an IBM Announcement Listserver. To initiate the 
service, send an e-mail note to announce@webster.ibmlink.ibm.com with the keyword subscribe in the body of 
the note (leave the subject line blank). A category form and detailed instructions will be sent to you. 
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Glossary 


APPLYLOG. A Data Restore feature function that 
applies the SQL statements, which had previously 
been extracted from the log (and log archives) during 
the RELOAD operation with RECOVERY=YES. 


archive. Generic term for а backup of а complete 
database. Determine from context whether а Data 
Restore archive (created by the Data Restore feature 
command BACKUP) or an DB2 archive is meant. See 
also "online" and "offline." 


ARCHIVE. The DB2 command ARCHIVE. 


backup. Generic term for backing up data. This can 
be either a user archive, or any of the DB2 commands 
DATAUNLOAD, UNLOAD, ARCHIVE or of the Data 
Restore feature commands UNLOAD, SELECT, 
BACKUP. 


BACKUP. A Data Restore feature function producing 
a Data Restore archive. 


buffer. А portion of storage used to hold input or 
output data temporarily. 


checkpoint. А set of cleanup and recovery actions 
taken periodically by the database manager. Actions 
include writing a copy of the database to disk, 
recording information in the DB2 log, and freeing 
storage pool space. 


cluster. A VSAM file in VSE. In VSE, a dbextent is 
implemented by a VSAM cluster. 


clustered index. An index whose sequence of key 
values closely corresponds to the sequence of rows 
stored in the table to which the index belongs. 


clustering index. The first index created for a table. 
The DB2 database manager uses it to determine the 
placement of subsequent rows. 


commit. (1) The operation that terminates a unit of 
work by releasing locks so that the database changes 
made by that unit of work can be perceived by other 
processes. (2) The process that allows data changes 
to be made permanent. When a commit occurs, other 
applications can reference the just-committed data. 


concurrency. The shared use of resources by 
multiple interactive users or application processes at 
the same time. 


COND. CONDITION for the UNLOAD command of 
Data Restore feature. Identifies whether the list of 
dbspaces is to be included or excluded for unloading. 


Control Center. 1. For VM & VSE - A set of database 
administration tools that automate database system 
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administration and operations. Control Center is the 
successor of SQL Master, and is a charged feature of 
IBM DB2 Server for VSE & VM Version 5. 


2. Part of DB2 Common Server, installed on either an 
OS/2 or AIX platform. Performs the administration for 
data replication. 


CS. See Cursor Stability. 


Cursor Stability . An isolation level that locks just 
the data you are using. When the cursor moves to a 
new row or page, the lock moves also (depending on 
the locking level defined) and previously read data is 
released. 


CUU. Channel and Unit address (virtual device 
address). 


database management system (DBMS). А software 
system that controls the logical and physical 
resources and facilities of а database. 


database manager. А program that processes SQL 
statements. 


Data Restore archive. Archive, taken with the Data 
Restore feature command BACKUP. Nearly identical 
is a translated DB2 archive, see "translated archive.” 


Data Restore feature. A feature of DB2 Server for 
VSE & VM that can be used for archiving and 
restoring DB2 Server for VSE & VM 


dbextent. The physical medium where database data 
is stored. In VM, an extent is implemented by a 
minidisk, in VSE by а VSAM cluster. Storage pools 
are composed of one or more dbextents. 


dbspace. А logical allocation of space in а storage 
pool contained in а database. Contains one or more 
tables and their associated indexes. 


DBSS. Database Storage Subsystem, а part of DB2 
Server for VSE & VM. 


DBSU. Database Services Utility, a part of DB2 
Server for VSE & VM. 


DCL. Data control language. 
DDL. Data definition language. 


DDR. DASD Dump Restore, а VM tool for disk 
backup. 


deadlock. An impasse that occurs when a process is 
waiting for a resource that is being held by another 
process that is waiting for a resource currently being 
held by the first process. 
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DELETE. А DB2 command to drop а row from а table. 


dependent table. A DB2 table which contains the 
foreign key relating to a primary key in another table. 
See parent table. 


DESCRIBE. A Data Restore feature function that 
produces a report about a Data Restore archive, a 
Data Restore translated DB2 archive or Data Restore 
unload file. 


Dirty Read . See Uncommitted Read. 
DML. Data manipulation language. 


exec. Execute file in VM to process a sequence of 
commands. 


EXEC. Filetype of an exec in VM. 
extent. See dbextent. 


FORMAT. Either a VM command or, for VSE, a Data 
Restore feature function to format an extent. 
Determine from context which one is meant. 


forward log recovery. see forward recovery 


forward recovery. After a backup had been taken, 
e.g. from a table (or a database), changes can have 
been made. DB2 writes these changes into the log 
and possibly into log archive(s). When a failure 
occurs and the table (or the database) has been 
restored, those updates must be applied to get the 
identical status of the table (or database) at the 
moment of the failure. 


guest sharing. A DB2 Server for VSE & VM facility 
that enables a user or application in a VSE, which 
runs as a guest operating system under VM, to 
access a VM DB2 database. 


heuristic. Pertaining to exploratory methods of 
problem solving in which solutions are discovered by 
evaluation of the progress made toward the final 
result. Contrast with algorithmic. 


IBM. International Business Machines Corporation. 


IDCAMS. A utility program, which is a part of VSAM 
in VSE. 


INSERT. A DB2 command to add a row to a table. 
ITSO. International Technical Support Organization. 


JCL. Job Control Language, for batch processing in 
VSE. 


KB. Kilobyte. 


key. See foreign key and primary key, parent table 
and dependent table. 
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LISTLOG. А Data Restore feature function listing 
those DB2 statements that have been extracted from 
the log and log archive and written into work files 
during a previous Data Restore RELOAD operation. 


lock. Mechanism used by the database manager to 
ensure the integrity of data. Locking prevents 
concurrent users from accessing inconsistent data. 


log. A collection of records maintained by the DB2 
database manager to describe events that occurred 
during the operation of the database. This 
information is used for recovery if a failure occurs 
while the database manager is executing. 


log archive. A log archive is a tape or disk copy of 
the log, recording just the changes applied to the data 
since the last archive or log archive. 


Logical Unit of Work (LUW). А recoverable sequence 
of operations within an application process. At any 
time, an application process is a single unit of work, 
but the life of an application process can involve 
many units of work as a result of “commit” or 
"rollback" operations. 


LRB. Lock Request Block. 


MUM. Multiple User Mode. A mode of operating the 
DB2 database manager, in which one or more users 
or application programs can access the database at 
the same time. Contrast with single user mode 
(SUM). 


NLRBS. Number of Lock Request Blocks for the 
System. This is an initialization parameter. 


NLRBU. Number of Lock Request Blocks for each 
User. This is an initialisation parameter. 


NULL. NULL is the contents of an "empty" column in 
DB2. NULLs can expressly be allowed or forbidden 
for each column. A NULL is not a zero ("0"), but, for 
example, will be ignored when building an average 
value. 


offline. While the database manager is not active. 
Archives that can be taken offline are DB2 archives, 
Data Restore feature BACKUP and user archives. 


online. While the database manager is active. 
Archives that can be taken online are only DB2 
archives. 


parent table. The related DB2 table with the primary 
key column referenced by the foreign key column in a 
dependent table. 


PCT. Processing Control Table, one of many CICS 
control tables. Assembling these tables is the older 
method compared to RDO. 


pool. See storage pool. 


PPT. Processing Program Table, one of many CICS 
control tables. Assembling these tables is the older 
method compared to RDO. 


primary key. The DB2 columns which together serve 
as the unique identifier of а relational row. See 
foreign key, parent table and dependent table. 


PSP. Preventive Service Planning information offered 
for IBM programs. 


primary key. A sum of DB2 Server for VSE & VM 
columns which together can identify а unique row. 


QMF. Query Management Facility, an IBM 
application program running on VSE/ESA (and other 
platforms) to query DB2 Server for VSE & VM data. 


recover. Either а generic term for repairing а 
system, а database or data from а failure. 

Or а specific term: to apply to а restored table those 
changes that had occurred after the backup copy had 
been taken. See forward recovery. 


RDO. Resource Definition Online, a method to 
configure CICS. 


reload. Generic term for loading data or loading a 
part of a database, like a table. This can be performed 
with either of the DB2 Server for VSE & VM 
commands DATALOAD, RELOAD or the Data Restore 
feature command RELOAD. 


RELOAD. A Data Restore feature function to load 
one single table from either of: 


* a DB2 archive 

* a translated DB2 archive 
* a Data Restore archive 

* a Data Restore unload file 


and optionally extract the applicable SQL statements 
from the log (and log archives) to prepare for a later 
forward log recovery through Data Restore 
APPLYLOG. 


Repeatable Read . An isolation level that locks data 
for the length of an LUW. 


Request Parameter List. A VSAM control block used 
by VSAM to perform an I/O. 


restore. Generic term for restoring data. This can be 
performed either through starting the database with 
the parameter STARTUP-R or F, or with a user 
restore (like DDR) and then starting the database with 
the parameter STARTUP=U, or with either of the DB2 
commands DATALOAD, RELOAD or the Data Restore 
feature commands RELOAD, RESTORE. 


RESTORE. A Data Restore feature function to restore 
a complete database. 


retention period. Specifies in VSE, how long a file is 
to be kept. 0 days means, it is not kept. 


rollback. The process of restoring data changed by 
SQL statements to the state at its last commit point. 
All locks are freed. Contrast with commit. 


RPL. Request Parameter List. This is a VSAM control 
block used by VSAM to perform an I/O. 


RR. See Repeatable Read. 


SELECT. A Data Restore feature function to select 
data from DB2 tables directly out of the dbextents, 
bypassing the database manager. 


SHOWDBS. A Data Restore feature function to 
execute a SHOW DBSPACE, bypassing the database 
manager. 


SIT. Systems Intitialization Table, one of many CICS 
control tables. Assembling these tables is the older 
method compared to RDO. 


DB2 archive. Archive, taken online with the DB2 
command ARCHIVE or offline with the DB2 command 
SQLEND ARCHIVE. 


SPLR. Storage Pool Level Recovery. 


SQLDBSU. SQL Database Services Utility, a part of 
DB2. 


SQL Master. An IBM program that provides a set of 
database administrator tools for DB2 databases within 
a VM or VSE environment. 


storage pool. A storage pool is composed of one or 
more dbextents, and defines the physical space for 
one or more dbspaces. 


SUM. Single User Mode. A mode of operation, in 
which the DB2 database manager and one application 
run in the same virtual machine. No other application 
programs or users can access the database at the 
same time. Contrast with multiple user mode (MUM). 


SYSIN. An input file for an exec in VM, containing 
definitions. 


SYSPRINT. An output file from a VM process. 


TRANSLATE. A Data Restore feature function that 
translates a DB2 archive into a Data Restore archive. 
For the difference between the results of Data 
Restore BACKUP and TRANSLATE see “translated 
archive." 


translated archive. The output from a Data Restore 
feature TRANSLATE command applied on a DB2 
archive. Nearly identical is a Data Restore archive 
taken with the Data Restore feature command 
BACKUP. The only difference is that 3 work files must 
be kept separately after a translation for a later Data 
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Restore RELOAD, whereas during Data Restore 
BACKUP this information is written in front of the 
Data Restore archive file. 


Uncommitted Read. A new Isolation level that allows 
access to data that has changed but not yet 
committed. Also called dirty read. 


unit of work. See "logical unit of work (LUW)." 


unload. Generic term to extract data from a 
database. This can be either of the DB2 commands 
DATAUNLOAD, UNLOAD, Data Restore feature 
commands SELECT, UNLOAD or SQL Master for VSE 
& VM commands SQLTABLE, SQLREORG. 


UNLOAD. Either the DB2 Database Services Utility 
command UNLOAD, or the Data Restore feature 
command UNLOAD. See the context to find which is 
meant, either in the heading, or in the words "DB2 
UNLOAD” versus "Data Restore UNLOAD.” Database 
Services Utility UNLOAD copies data from a dbspace 
or table. Data Restore UNLOAD copies data from one 
or more dbspaces. 


update. Generic term. In DB2, this might include the 
commands UPDATE, INSERT and DELETE. 
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UPDATE. A DB2 command to modify existing data. 
UR. See Uncommitted Read. 


user archive. An archive that is taken using non-DB2 
facilities. 


VM. Any version and release of VM/ESA, supported 
by DB2 Server for VSE & VM Version 5 Release 1. 


VM/ESA. Virtual Machine/Enterprise Systems 
Architecture, a System/390 operating system. 


VMDSS. DB2 Data Spaces Support for VM/ESA, 
previously a charged feature of SQL/DS. Integrated in 
DB2 Server for VM Version 5. 


VMPRF. VM Performance Reporting Facility, an IBM 
program. 


VSAM. Virtual Storage Access Method, a file access 
method in VSE, VM and MVS. 


VSE. Any version and release of VSE/ESA, supported 
by DB2 Server for VSE & VM Version 5 Release 1. 


VSE/ESA. Virtual Storage Extended/Enterprise 
Systems Architecture, a System/390 operating 
system. 
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Data Base Services Utility 
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Distributed Relational 
Database Architecture 


Distributed Unit of Work 


Enterprise Systems 
Architecture 


Group Control System 
Graphics Interchange Format 
Graphical User Interface 
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